Jira · AsyncAPI Specification

Jira Cloud Webhooks

Version 3

Jira Cloud webhooks deliver HTTP POST payloads to a configured URL whenever specified events occur in your Jira instance. Webhooks can be registered via the Jira REST API or through the Jira administration UI. Each webhook delivery includes a JSON payload with details about the event, the affected entities, and a timestamp. Jira supports both dynamic webhooks (registered via REST API with expiration) and static webhooks (configured in app descriptors for Connect apps). Forge apps use a separate event trigger mechanism.

View Spec View on GitHub AgileIssue TrackingITSMProject ManagementService ManagementAsyncAPIWebhooksEvents

Channels

/webhook
publish receiveJiraWebhookEvent
Receive a Jira webhook event
The endpoint that receives all Jira Cloud webhook event deliveries. The event type is identified by the webhookEvent field in the JSON payload. Jira retries failed deliveries (non-200 responses) up to 8 times with exponential backoff.

Messages

✉
jira:issue_created
Issue Created
Fired when a new issue is created in Jira.
✉
jira:issue_updated
Issue Updated
Fired when an existing issue is updated in Jira.
✉
jira:issue_deleted
Issue Deleted
Fired when an issue is deleted from Jira.
✉
comment_created
Comment Created
Fired when a comment is added to an issue.
✉
comment_updated
Comment Updated
Fired when an existing comment on an issue is edited.
✉
comment_deleted
Comment Deleted
Fired when a comment is removed from an issue.
✉
issuelink_created
Issue Link Created
Fired when a link between issues is created.
✉
issuelink_deleted
Issue Link Deleted
Fired when a link between issues is removed.
✉
attachment_created
Attachment Created
Fired when an attachment is added to an issue.
✉
attachment_deleted
Attachment Deleted
Fired when an attachment is removed from an issue.
✉
worklog_created
Worklog Created
Fired when a worklog entry is added to an issue.
✉
worklog_updated
Worklog Updated
Fired when a worklog entry is edited on an issue.
✉
worklog_deleted
Worklog Deleted
Fired when a worklog entry is removed from an issue.
✉
project_created
Project Created
Fired when a new project is created.
✉
project_updated
Project Updated
Fired when a project is updated.
✉
project_deleted
Project Deleted
Fired when a project is permanently deleted.
✉
project_soft_deleted
Project Soft Deleted
Fired when a project is moved to the trash.
✉
project_restored_deleted
Project Restored from Trash
Fired when a project is restored from the trash.
✉
sprint_created
Sprint Created
Fired when a sprint is created.
✉
sprint_updated
Sprint Updated
Fired when a sprint is updated.
✉
sprint_deleted
Sprint Deleted
Fired when a sprint is deleted.
✉
sprint_started
Sprint Started
Fired when a sprint is started.
✉
sprint_closed
Sprint Closed
Fired when a sprint is closed (completed).
✉
board_created
Board Created
Fired when a board is created.
✉
board_updated
Board Updated
Fired when a board is updated.
✉
board_deleted
Board Deleted
Fired when a board is deleted.
✉
user_created
User Created
Fired when a new user is created.
✉
user_updated
User Updated
Fired when a user account is updated.
✉
user_deleted
User Deleted
Fired when a user account is deleted.
✉
option_voting_changed
Voting Option Changed
Fired when the voting option is enabled or disabled.
✉
option_watching_changed
Watching Option Changed
Fired when the watching option is enabled or disabled.
✉
option_unassigned_issues_changed
Unassigned Issues Option Changed
Fired when the unassigned issues option is changed.
✉
option_subtasks_changed
Sub-tasks Option Changed
Fired when the sub-tasks option is enabled or disabled.
✉
option_attachments_changed
Attachments Option Changed
Fired when the attachments option is enabled or disabled.
✉
option_issuelinks_changed
Issue Links Option Changed
Fired when the issue links option is enabled or disabled.
✉
option_timetracking_changed
Time Tracking Option Changed
Fired when the time tracking option is enabled or disabled.

Servers

https
webhook-receiver {webhookUrl}
Your webhook receiver endpoint. Jira sends POST requests to this URL when subscribed events occur. The URL must be publicly accessible and respond with a 200-level status code within 10 seconds.