---
title: "Create issue field for an organization"
method: POST
path: "/orgs/{org}/issue-fields"
tags: ["orgs"]
---

# Create issue field for an organization

`POST /orgs/{org}/issue-fields`

Creates a new issue field for an organization.

You can find out more about issue fields in [Managing issue fields in an organization](https://docs.github.com/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-an-organization).

To use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and
personal access tokens (classic) need the `admin:org` scope to use this endpoint.

## Path parameters

- `org` string, required

## Request body

- OrganizationCreateIssueField
  - `name` string, required — Name of the issue field.
  - `description` string, nullable — Description of the issue field.
  - `data_type` 'text' | 'date' | 'single_select' | 'multi_select' | 'number', required — The data type of the issue field.
  - `visibility` 'organization_members_only' | 'all' — The visibility of the issue field. Can be `organization_members_only` (visible only within the organization) or `all` (visible to all users who can see issues). Only used when the visibility settings feature is enabled. Defaults to `organization_members_only`.
  - `options` object[], nullable — Options for select fields. Required when data_type is 'single_select' or 'multi_select'.
    - `name` string, required — Name of the option.
    - `description` string, nullable — Description of the option.
    - `color` 'gray' | 'blue' | 'green' | 'yellow' | 'orange' | 'red' | 'pink' | 'purple', required — Color for the option.
    - `priority` integer, required — Priority of the option for ordering.

## Response `200`

Response

- IssueField, nullable — A custom attribute defined at the organization level for attaching structured data to issues.
  - `id` integer, required — The unique identifier of the issue field.
  - `node_id` string, required — The node identifier of the issue field.
  - `name` string, required — The name of the issue field.
  - `description` string, nullable — The description of the issue field.
  - `data_type` 'text' | 'date' | 'single_select' | 'multi_select' | 'number', required — The data type of the issue field.
  - `visibility` 'organization_members_only' | 'all' — The visibility of the issue field. Can be `organization_members_only` (visible only within the organization) or `all` (visible to all users who can see issues).
  - `options` object[], nullable — Available options for single select and multi select fields.
    - `id` integer, required — The unique identifier of the option.
    - `name` string, required — The name of the option.
    - `description` string, nullable — The description of the option.
    - `color` 'gray' | 'blue' | 'green' | 'yellow' | 'orange' | 'red' | 'pink' | 'purple', nullable — The color of the option.
    - `priority` integer, nullable — The priority of the option for ordering.
    - `created_at` string, date-time — The time the option was created.
    - `updated_at` string, date-time — The time the option was last updated.
  - `created_at` string, date-time — The time the issue field was created.
  - `updated_at` string, date-time — The time the issue field was last updated.

## Other responses

- `404` — Resource not found
- `422` — Validation failed, or the endpoint has been spammed.

---

[API](https://skmtc.net/github/apis/github-v3-rest-api.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api/versions/a367f7028301/schema)