Skip to main content

Jira Integration

Dispatch integrates with Jira to receive webhook events when issues are created, updated, or deleted in your projects.

Connecting Jira​

  1. Navigate to your project's Sources page
  2. Click Connect Jira
  3. Authorize the Dispatch Jira OAuth app
  4. Select a Jira project and the events you want to receive

Dispatch will:

  • Create a webhook endpoint with provider = "jira"
  • Register a webhook on the selected Jira project
  • Configure the endpoint to receive the selected event types

Supported Jira Events​

EventDescription
jira:issue_createdIssue created
jira:issue_updatedIssue field changed
jira:issue_deletedIssue deleted
comment_createdComment added to an issue
comment_updatedComment edited
comment_deletedComment removed

The event type is extracted from the webhookEvent field in the Jira payload.

Signature Verification​

Jira webhooks include a JWT in the Authorization header. Dispatch verifies this automatically. When connecting via OAuth, Dispatch manages the signing secret configuration for you.

Auto-Formatted Embeds​

When no custom template is assigned, Dispatch auto-detects Jira payloads and generates specialized embeds:

jira:issue_created​

  • Shows issue key and summary
  • Includes issue type, priority, and assignee
  • Links to the issue in Jira

jira:issue_updated​

  • Shows the issue key and what changed
  • Displays old and new field values for changed fields

jira:issue_deleted​

  • Shows the issue key and summary of the deleted issue

Disconnecting​

To disconnect a Jira project:

  1. Go to Sources and find the Jira endpoint
  2. Click Disconnect
  3. Dispatch removes the webhook from Jira and deactivates the endpoint