---
title: "Create a mac object"
method: POST
path: "/mac-object-profiles"
tags: ["Configuration - Policy"]
---

# Create a mac object

`POST /mac-object-profiles`

Create a new mac object

## Request body

- XiqCreateMacObjectRequest
  - `name` string, required — The product model
  - `description` string — The product description
  - `value` string, required — The MAC octets.
  - `mac_type` 'MAC_OUI' | 'MAC_RANGE' | 'MAC_ADDRESS', required — The MAC object type e.g, "MAC_OUI", "MAC_RANGE" or "MAC_ADDRESS"
  - `mac_address_end` string — The MAC address end, only available for "MAC_RANGE" type.

## Response `201`

Created

- XiqMacObject — The MAC Object.
  - `id` integer, required — The unique identifier
  - `create_time` string, date-time, required — The create time in UTC (ISO 8601 format)
  - `update_time` string, date-time, required — The last update time in UTC (ISO 8601 format)
  - `org_id` integer — The organization identifier, valid when enabling HIQ feature
  - `name` string — The MAC object name
  - `description` string — The MAC object description.
  - `predefined` boolean — Whether the MAC Oui is predefined
  - `value` string — The MAC octets in hexadecimal format without separators. For MAC_OUI: 6 characters (e.g., '001DA2'). For MAC_ADDRESS or MAC_RANGE: 12 characters (e.g., 'AABBCCDDEEFF').
  - `mac_type` 'MAC_OUI' | 'MAC_RANGE' | 'MAC_ADDRESS' — The MAC object type e.g, "MAC_OUI", "MAC_RANGE" or "MAC_ADDRESS"
  - `defender_defined` boolean — Whether defender is defined
  - `mac_address_end` string — The MAC address end in hexadecimal format without separators (12 characters), only available for "MAC_RANGE".

---

[API](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api.md) · [All operations](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/extremecloudiq/extremecloud-iq-api/versions/5ff7ab84e8e8/schema)