GitHub GraphQL `createIssueField` mutation adds issue fields
Introduced 2026-03-12 · score 0.96
HOW TO USE IT
When creating an issue field for an organization, call `Mutation.createIssueField` with `dataType`, `name`, and the organization’s `ownerId`. Include `options` when applicable, such as for single-select fields.
mutation { createIssueField(input: { dataType: <ISSUE_FIELD_DATA_TYPE>, name: "<field name>", ownerId: "<organization node ID>" }) { issueField { __typename } } }WHY THIS HELPS
Create an issue field through the GitHub GraphQL API.
REQUIREMENTS AND LIMITATIONS
- input (required): `CreateIssueFieldInput` for the mutation.
- dataType (required): Issue field data type (`IssueFieldDataType`).
- name (required): Name of the issue field.
- ownerId (required): ID of the organization where the field will be created.
- description: Description of the issue field.
- visibility: Visibility of the issue field (`IssueFieldVisibility`).
- clientMutationId: Unique identifier for the client performing the mutation.
- options: Options for the issue field if applicable; each option has required `color` (associated color), required `name` (option name), required `priority` (list priority), and optional `description`.
- options[].color (required): Color associated with the single-select option (`IssueFieldSingleSelectOptionColor`).
- options[].name (required): Name of the single-select option.
- options[].priority (required): Priority of the option in the list.
- options[].description: Description of the option.
- `dataType`, `name`, and `ownerId` are required inputs.
- `options` has type `[IssueFieldSingleSelectOption!]`.
FIRST-PARTY EVIDENCE
- https://docs.github.com/en/graphql/overview/changelog#schema-changes-for-2026-03-12
- https://docs.github.com/en/graphql/reference/issues
Check the installed version and the source before using it. Entry JSON