---
title: "Create priority"
method: POST
path: "/rest/api/3/priority"
tags: ["Issue priorities"]
---

# Create priority

`POST /rest/api/3/priority`

Creates an issue priority.

**Deprecation notice:** The `iconUrl` parameter was sunset on 16th Mar 2025, and replaced with `avatarId`. See [CHANGE-1525](https://developer.atlassian.com/changelog/#CHANGE-1525).

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

## Request body

- CreatePriorityDetails — Details of an issue priority.
  - `avatarId` integer — The ID for the avatar for the priority. Either the iconUrl or avatarId must be defined, but not both. This parameter is nullable and will become mandatory once the iconUrl parameter is deprecated.
  - `description` string, nullable — The description of the priority.
  - `iconUrl` '/images/icons/priorities/blocker.png' | '/images/icons/priorities/critical.png' | '/images/icons/priorities/high.png' | '/images/icons/priorities/highest.png' | '/images/icons/priorities/low.png' | '/images/icons/priorities/lowest.png' | '/images/icons/priorities/major.png' | '/images/icons/priorities/medium.png' | '/images/icons/priorities/minor.png' | '/images/icons/priorities/trivial.png' | '/images/icons/priorities/blocker_new.png' | '/images/icons/priorities/critical_new.png' | '/images/icons/priorities/high_new.png' | '/images/icons/priorities/highest_new.png' | '/images/icons/priorities/low_new.png' | '/images/icons/priorities/lowest_new.png' | '/images/icons/priorities/major_new.png' | '/images/icons/priorities/medium_new.png' | '/images/icons/priorities/minor_new.png' | '/images/icons/priorities/trivial_new.png', nullable — The URL of an icon for the priority. Accepted protocols are HTTP and HTTPS. Built in icons can also be used. Either the iconUrl or avatarId must be defined, but not both.
  - `name` string, required — The name of the priority. Must be unique.
  - `statusColor` string, required — The status color of the priority in 3-digit or 6-digit hexadecimal format.

## Response `201`

Returned if the request is successful.

- PriorityId — The ID of an issue priority.
  - `id` string, required — The ID of the issue priority.

## Other responses

- `400` — Returned if the request isn't valid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user doesn't have the necessary permission.

---

[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/5a51740d7ab3/schema)