---
title: "Create custom field context"
method: POST
path: "/rest/api/3/field/{fieldId}/context"
tags: ["Issue custom field contexts"]
---

# Create custom field context

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

Creates a custom field context.

If `projectIds` is empty, a global context is created. A global context is one that applies to all project. If `issueTypeIds` is empty, the context applies to all issue types.

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

## Path parameters

- `fieldId` string, required

## Request body

- CreateCustomFieldContext — The details of a created custom field context.
  - `description` string — The description of the context.
  - `id` string — The ID of the context.
  - `issueTypeIds` string[] — The list of issue types IDs for the context. If the list is empty, the context refers to all issue types.
  - `name` string, required — The name of the context.
  - `projectIds` string[] — The list of project IDs associated with the context. If the list is empty, the context is global.

## Response `201`

Returned if the custom field context is created.

- CreateCustomFieldContext — The details of a created custom field context.
  - `description` string — The description of the context.
  - `id` string — The ID of the context.
  - `issueTypeIds` string[] — The list of issue types IDs for the context. If the list is empty, the context refers to all issue types.
  - `name` string, required — The name of the context.
  - `projectIds` string[] — The list of project IDs associated with the context. If the list is empty, the context is global.

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `404` — Returned if the field, project, or issue type is not found.
- `409` — Returned if the issue type is a sub-task, but sub-tasks are disabled in Jira settings.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/ec7f275dfee5/schema)