---
title: "Create a custom attribute"
method: POST
path: "/people/2/customAttributes"
tags: ["customer-engagement", "people", "custom-attributes"]
---

# Create a custom attribute

`POST /people/2/customAttributes`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/people/2/customAttributes`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`
  - API key in header `Authorization`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Create a new custom attribute by using this method.

## Request body

- 0797f98960a9d1f4df946ffe53c3c4e3e5cdc1dc56732cd123c79fa96c6ddca1IamCustomAttribute
  - `createdAt` string: Date and time of creation. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
  - `dataType` 'STRING' | 'DECIMAL' | 'INTEGER' | 'BOOLEAN' | 'DATE' | 'DATE_TIME' | 'LIST_OF_OBJECTS'
  - `modifiedAt` string: Date and time of last modification. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
  - `name` string: Custom attribute name, 256 characters max. Invalid characters: `{}[]`.
  - `objectSchema` object: Object schema for `LIST_OF_OBJECTS` type. Defines the shape of the list items.

## Response `200`

successful response

- 0797f98960a9d1f4df946ffe53c3c4e3e5cdc1dc56732cd123c79fa96c6ddca1IamCustomAttribute
  - `createdAt` string: Date and time of creation. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
  - `dataType` 'STRING' | 'DECIMAL' | 'INTEGER' | 'BOOLEAN' | 'DATE' | 'DATE_TIME' | 'LIST_OF_OBJECTS'
  - `modifiedAt` string: Date and time of last modification. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
  - `name` string: Custom attribute name, 256 characters max. Invalid characters: `{}[]`.
  - `objectSchema` object: Object schema for `LIST_OF_OBJECTS` type. Defines the shape of the list items.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error
- `4XX`: Error responses
- `5XX`: Error responses

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)