---
title: "POST /custom-fields/{id}/select-options"
method: POST
path: "/custom-fields/{id}/select-options"
tags: ["custom-fields"]
---

# POST /custom-fields/{id}/select-options

`POST /custom-fields/{id}/select-options`

Create a custom field select option
Adds an option to a select or multiselect custom field.

**Rate limit:** 120 requests per minute

## Path parameters

- `id` string, required

## Request body

- CreateCustomFieldSelectOptionRequestBody
  - `ai_description` string — The AI description used to help AI-enabled fields select this option.
  - `label` string, required — The display label of the option.
  - `slug` string, required — The API slug stored as the option value.

## Response `200`

- CreateCustomFieldSelectOptionResponseBody
  - `data` CustomFieldDefinitionSelectOption
    - `ai_description` string — The AI description of the option. This is used to help the AI understand when to select this option.
    - `label` string — The label of the option.
    - `slug` string — The slug of the option.
  - `request_id` string — The request ID for tracking.

## Other responses

- `400` — The request was invalid or could not be completed.
- `403` — The authenticated caller or organization is not allowed to access this endpoint or operation.
- `404`
- `500` — An unexpected internal error occurred.

## Changes

- **2026-09-02** `cef2ab0dd800` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usepylon/apis/pylon-api/changes/custom-fields/:id/select-options/post.md)

---

[API](https://skmtc.dev/usepylon/apis/pylon-api.md) · [All operations](https://skmtc.dev/usepylon/apis/pylon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usepylon/pylon-api/revisions/cef2ab0dd800/schema)