---
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

---

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