# Create contact field definition

**POST** `/contacts/custom-fields`

Creates a reusable custom field for storing customer context on contacts.

Authentication: bearerAuth
Required scopes: `custom_field:create`
Allowed roles: `owner`, `admin`, `agent`
Authorization: Create a contact field definition.

## Request body

- `application/json`: `CreateCustomFieldDefinitionRequest` required.

## Responses

- `201`: Contact field definition created
- `default`: Error