GuidesIntegrations
Jira
Track incident-related work items and action items in Jira. Create, link, and sync Jira issues from Runframe incidents.
Jira
Track incident-related work items and action items directly in Jira.
Features
| Feature | Description |
|---|---|
| Create Jira issues | Create follow-up tickets from incidents |
| Status sync | Jira issue status syncs with Runframe via webhooks |
| Link to incidents | Jira issues are linked to their source incident |
| Transition issues | Update Jira issue status from within Runframe |
Connecting Jira
- Navigate to Integrations Hub
- Click Connect next to Jira — you'll be redirected to Atlassian to authorize
- Grant Runframe read/write access to your Jira projects
- Select the default Jira project for incident work items
Creating a Jira issue from an incident
- Open an incident in the Runframe dashboard
- Click Create Jira Issue in the sidebar
- Select the project, issue type, and fill in details
- The issue is created and linked to the incident
Status syncing
When a Jira issue status changes, Runframe is notified via webhook and updates the work item status in the incident view. This works in both directions:
- Jira to Runframe: Status transitions in Jira update the work item in Runframe
- Runframe to Jira: Transitioning a work item in Runframe updates the Jira issue
Webhook configuration
Runframe automatically configures Jira webhooks during setup. The webhook listens for:
- Issue created
- Issue updated (status transitions)
- Issue deleted
Use with postmortems
After a postmortem, create Jira issues for each action item to ensure follow-through. Action items linked to Jira issues show their real-time status in the postmortem view.
Use Jira for action items
After a postmortem, create Jira issues for each action item to ensure follow-through and accountability.
Troubleshooting
| Issue | Solution |
|---|---|
| OAuth error during connection | Verify you have Jira admin permissions |
| Issues not syncing | Check webhook status in Jira admin settings |
| Wrong project appearing | Update default project in Runframe integration settings |
| Permission denied | Ensure Runframe has read/write access to the project |