Jira
Why
Jira Integration allows you to:
- Creating an incident in Rootly will create an issue in Jira if you choose to.
- Creating an action item in Rootly will create an issue in Jira if you choose to. Attached as subtasks if incident has been created in Jira as well.
- Changing incident title, description, status in Rootly will update the issue in Jira.
- Changing action item title, description, status in Rootly will update the issue in Jira.
- Changing Jira incident issue attributes will not update incident attributes in Rootly.
- Changing Jira action item issue attributes will update action item attributes in Rootly. ( See Webhooks section to make this feature works )
Installation
You can setup this integration as a logged in admin user in the integrations page:

We recommend you integrating with a service account to make sure the integration doesn't break if a user leaves your company.
Settings
You custom map your Jira issue status to Rootly ones through the Integration Settings page.

Custom fields mapping
You can configure custom column mapping using our custom variables Incident Variables.
How to find id for custom field(s)?
https://confluence.atlassian.com/jirakb/how-to-find-id-for-custom-field-s-744522503.html
Update payload add issuelinks example
Update payload add comments example
Update payload severities example
Oauth Permissions
Your selected workspace needs the following oauth permissions:
- read:application-role:jira
- read:avatar:jira
- read:field-configuration:jira
- read:group:jira
- read:issue:jira
- read:issue-status:jira
- read:issue-meta:jira
- read:issue-security-level:jira
- read:issue-type:jira
- read:issue-type-hierarchy:jira
- read:issue.changelog:jira
- read:issue.transition:jira
- read:issue.vote:jira
- read:priority:jira
- read:project:jira
- read:project-category:jira
- read:project-version:jira
- read:project.component:jira
- read:project.property:jira
- read:status:jira
- read:user:jira
- read:user.property:jira
- write:attachment:jira
- write:comment:jira
- write:comment.property:jira
- write:issue:jira
- write:issue.property:jira
Permissions
Your selected workspace needs the following permissions:
- Assign Issues - Ability to assign issues to other people
- Close Issues - Ability to close issues. Often useful where your developers resolve issues, and a QA department closes them.
- Create Issues - Ability to create issues.
- Delete Issues - Ability to delete issues.
- Edit Issues - Ability to edit issues.
- Link Issues - Ability to link issues together and create linked issues.
- Transition issues - Permission to transition (change) the status of an issue.
More help on https://confluence.atlassian.com/adminjiraserver073/managing-project-permissions-861253293.html
Webhooks
To get Jira to update Rootly action items, you need to configure Webhooks. Additional documentation can be found here.
Go into Jira Software System panel > Webhooks

Create a new webhook and copy the Rootly webhook url into the url input.

Finally let's allow the webhook to listen to Issue events.

All done !
Create Incidents from Jira Tickets Automatically
Support
If you need help or more information about this integration, please contact support@rootly.com or use the lower right chat widget to get connected with an engineer.
Uninstall
You can uninstall this integration in the integrations panel by clicking Configure > Delete

