# Create property field definition

**POST** `/properties/custom-fields`

Creates a reusable custom field for storing context on property records.

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

## Request body

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

## Responses

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