---
title: "Create a New Custom Attribute"
method: POST
path: "/api/v2/custom-attributes"
tags: ["Custom Attributes"]
---

# Create a New Custom Attribute

`POST /api/v2/custom-attributes`

This endpoint creates a new custom attribute for the current organization. Your organization must register custom attributes before values can be assigned to users associated with the attribute. A maximum of 50 custom attributes can be added.<h3>Required Scope</h3>`custom_attribute:write`

## Request body

- V2CustomattributesBody
  - `data` Apiv2customattributesData
    - `type` string, nullable
    - `attributes` Apiv2customattributesDataAttributes
      - `name` string — The name of the custom attribute.
      - `data-type` string — The data type of the attribute values to be associated with users. Options include `Bool`, `String`, `Number`, and `DateTime`.

## Response `201`

Success

- CustomAttributeDetail
  - `data` CustomAttributeDetailData
    - `type` string, nullable
    - `id` string — The unique id of the custom attribute.
    - `attributes` CustomAttributeDetailDataAttributes
      - `name` string — The name of the custom attribute.
      - `data-type` string — The data type of the attribute values to be associated with users. Options include `Bool`, `String`, `Number`, and `DateTime`.
      - `is-visibile-in-ui` boolean — Whether the custom attribute is visible in the UI.

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)