Send notification for issue

POST

/rest/api/3/issue/{issueIdOrKey}/notify

Creates an email notification for an issue and adds it to the mail queue.

Permissions required:

Browse Projects project permission for the project that the issue is in.

If issue-level security is configured, issue-level security permission to view the issue.

Request

Path Params

Body Params application/json

Examples

Responses

🟢204No Content

application/json

Returned if the email is queued for sending.

Body

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/issue//notify' \
--header 'Content-Type: application/json' \
--data-raw '{
    "htmlBody": "The <strong>latest</strong> test results for this ticket are now available.",
    "restrict": {
        "groupIds": [],
        "groups": [
            {
                "name": "notification-group"
            }
        ],
        "permissions": [
            {
                "key": "BROWSE"
            }
        ]
    },
    "subject": "Latest test results",
    "textBody": "The latest test results for this ticket are now available.",
    "to": {
        "assignee": false,
        "groupIds": [],
        "groups": [
            {
                "name": "notification-group"
            }
        ],
        "reporter": false,
        "users": [
            {
                "accountId": "5b10a2844c20165700ede21g",
                "active": false
            }
        ],
        "voters": true,
        "watchers": true
    }
}'

Response Example

null

Modified at 2025-07-16 07:18:01

Get edit issue metadata

Get transitions