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