---
title: "Creates a custom field selection option for an existing custom field definition."
method: POST
path: "/customfielddefinitions/{customFieldDefinitionId}/selectionoptions"
tags: ["customFields"]
---

# Creates a custom field selection option for an existing custom field definition.

`POST /customfielddefinitions/{customFieldDefinitionId}/selectionoptions`

<Check title="Required Permissions" icon="key">The user must be an admin or have `project-manage-config:write` permissions.</Check>

## Path parameters

- `customFieldDefinitionId` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- CustomFieldSelectionOptionsForm
  - `value` string, required — The selection value which can be used in a select custom field.
  - `color` 'red' | 'orange' | 'yellow' | 'green' | 'cyan' | 'blue' | 'indigo' | 'purple' | 'steel' — The color of the selection option.
  - `order` number, double, required — The order of the custom field selection option.

## Response `200`

OK

- CustomFieldSelectionOption
  - `id` string, uuid — The id of the custom field selection option.
  - `value` string, required — The selection value which can be later used in a select custom field.
  - `color` 'red' | 'orange' | 'yellow' | 'green' | 'cyan' | 'blue' | 'indigo' | 'purple' | 'steel' — The color of the selection option.
  - `order` number, double — The order of the custom field selection option.

## Other responses

- `404` — Not Found

## Changes

- **2026-08-21** `a13e7c704262` — 1 breaking, 1 warning
  - the `value` request property's minLength was increased from `0` to `1`
  - the `value` request property's maxLength was set to `255`

[Change history](https://skmtc.dev/awork-io/apis/api-v1-reference/changes/customfielddefinitions/:customFieldDefinitionId/selectionoptions/post.md)

---

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