---
title: "Create custom field options (context)"
method: POST
path: "/rest/api/3/field/{fieldId}/context/{contextId}/option"
tags: ["Issue custom field options"]
---

# Create custom field options (context)

`POST /rest/api/3/field/{fieldId}/context/{contextId}/option`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/api/3/field/{fieldId}/context/{contextId}/option`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://auth.atlassian.com/authorize`
    - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `manage:jira-configuration`

Creates options and, where the custom select field is of the type Select List (cascading), cascading options for a custom select field. The options are added to a context of the field.

The maximum number of options that can be created per request is 1000 and each field can have a maximum of 10000 options.

This operation works for custom field options created in Jira or the operations from this resource. **To work with issue field select list options created for Connect apps use the [Issue custom field options (apps)](#api-group-issue-custom-field-options--apps-) operations.**

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Path parameters

- `fieldId` string, required
- `contextId` integer, required

## Request body

- BulkCustomFieldOptionCreateRequest: Details of the options to create for a custom field.
  - `options` CustomFieldOptionCreate[]: Details of options to create.
    - `disabled` boolean: Whether the option is disabled.
    - `optionId` string: For cascading options, the ID of a parent option.
    - `value` string, required: The value of the custom field option.

## Response `200`

Returned if the request is successful.

- CustomFieldCreatedContextOptionsList: A list of custom field options for a context.
  - `options` CustomFieldContextOption[]: The created custom field options.
    - `disabled` boolean, required: Whether the option is disabled.
    - `id` string, required: The ID of the custom field option.
    - `optionId` string: For cascading options, the ID of the custom field option containing the cascading option.
    - `value` string, required: The value of the custom field option.

## Other responses

- `400`: Returned if the request is not valid.
- `401`: Returned if the authentication credentials are incorrect or missing.
- `403`: Returned if the user does not have the necessary permission.
- `404`: Returned if the custom field is not found or the context doesn't match the custom field.
- `422`: Returned if creating the options would exceed the maximum number of options allowed for the custom field.

## Changes

- **2026-10-12** `204ee0854f0c`: 1 info
  - added the non-success response with the status `422`

[Operation history](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/changes/rest/api/3/field/:fieldId/context/:contextId/option/post.md)

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3.md) - [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/revisions/f22db3da5feb?raw)