---
title: "Create notification scheme"
method: POST
path: "/rest/api/2/notificationscheme"
tags: ["Issue notification schemes"]
---

# Create notification scheme

`POST /rest/api/2/notificationscheme`

Creates a notification scheme with notifications. You can create up to 1000 notifications per request.

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

## Request body

- CreateNotificationSchemeDetails — Details of an notification scheme.
  - `description` string — The description of the notification scheme.
  - `name` string, required — The name of the notification scheme. Must be unique (case-insensitive).
  - `notificationSchemeEvents` NotificationSchemeEventDetails[] — The list of notifications which should be added to the notification scheme.
    - `event` NotificationSchemeEventTypeId, required — The ID of an event that is being mapped to notifications.
      - `id` string, required — The ID of the notification scheme event.
    - `notifications` NotificationSchemeNotificationDetails[], required — The list of notifications mapped to a specified event.
      - `notificationType` string, required — The notification type, e.g `CurrentAssignee`, `Group`, `EmailAddress`.
      - `parameter` string — The value corresponding to the specified notification type.

## Response `201`

Returned if the request is successful.

- NotificationSchemeId — The ID of a notification scheme.
  - `id` string, required — The ID of a notification scheme.

## 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.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/versions/a26541c2f8bd/schema)