---
search:
  tags:
    - administration
    - POST
seo:
  description: >-
    Creates a new custom field for capturing… Reference for the POST
    /administration/organization-settings/custom-fields endpoint in the Leadtime
    Public API API.
sidebar:
  badge: POST
  label: Create organization custom field
title: Create organization custom field
type: openapi-operation
---
Creates a new custom field for capturing additional organization information.

**Required fields:**
- `name`: Display name for the field (e.g., "Priority Level", "Region")
- `type`: Field type enum value (Text, Textarea, Number, Date, Checkbox, Select, MultiSelect)
- `translations`: Array of translations for multilingual support

**Optional fields:**
- `id`: Optional ID for the field (for updating existing fields)
- `description`: Additional context about the field
- `selectOptions`: Required for Select and MultiSelect types - array of option objects with:
  - `id`: Optional identifier (use value if not provided)
  - `value`: Display value for the option
  - `translations`: Array of translations for the option name
- `translationsDescriptions`: Translations for the field description

**Field type requirements:**
- Select and MultiSelect types MUST include selectOptions array
- Other types do not use selectOptions

**Values in organization writes:**
Use the configured field ID as a key in organization `customFields`, with a value matching this definition type. Custom fields store typed data; they do not create native relationships or behavior.

**Note:** Once created, the custom field will appear when creating or editing organizations. The field can be reordered using the sort endpoint.

<Operation source="api-reference" id="organizationsettingscontroller-createorganizationcustomfield" />