> For the complete documentation index, see [llms.txt](https://docs.incidenthub.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incidenthub.cloud/incidenthub-documentation/channels/integration-for-atlassian-jira-service-management.md).

# Integration for Atlassian Jira Service Management

You can integrate IncidentHub with Atlassian Jira Service Management (JSM) to receive notifications as support tickets in your JSM space.

IncidentHub will create tickets in your JSM space when any of the following happens:

1. An incident or maintenance is triggered (started).

IncidentHub does not send follow up notifications to Atlassian Jira Service Management for the same incident or maintenance, including for updates and resolved events. It also does not send upcoming maintenance reminders to JSM.

## In Your Atlassian Jira Service Management Account

1. Login to your Atlassian account and click on your profile picture on the top right corner.
2. Click on "Account Settings" in the menu.
3. On your account page (typically <https://id.atlassian.com/manage-profile/profile-and-visibility>) click on Security, then "Create and manage API tokens".
4. You will see a list of your API tokens.&#x20;

<figure><img src="/files/gahAaB1gWUf6HIRJWgAY" alt=""><figcaption></figcaption></figure>

5. Click on "Create API token" and give it a descriptive name. Set "Expires on" to the maximum value which is 1 year. Note that Atlassian tokens cannot be set to remain valid for longer than a year - so you will need to re-do this integration when the token expires.

<figure><img src="/files/ekaHVsKCkr9UWXJzy0gq" alt=""><figcaption></figcaption></figure>

6. Copy the API token - you will need it in the next step.

## In Your IncidentHub Account

1. Login to your IncidentHub account and click on Channels -> Add -> Jira Service Management.
2. Add a Name and and a Description.
3. For "Atlassian site URL", enter the URL of your JSM portal. This usually looks like `https://mycompany.atlassian.net`.
4. For "Atlassian Email", enter the email which you use to login to your Atlassian account.
5. For "API token", enter the API token you copied earlier.
6. For "Project Key", find your project key. You can find it from your URL when you open your Space in the browser. E.g. for [`https://cloud566.atlassian.net/jira/servicedesk/projects/INT/`](https://cloud566.atlassian.net/jira/servicedesk/projects/INT/queues/custom/) the Project Key is `INT`
7. For "Issue Type", find the possible types first. Click on "Create" in your Atlassian portal. In the form which opens, under "Work type" you will see a list of valid values. In the example below, the type is "\[System] Incident". Choose whichever value that you wish to be associated with tickets by IncidentHub.

<figure><img src="/files/GkxVqB8H3xwHc5SKamka" alt=""><figcaption></figcaption></figure>

8. To ensure that the details are valid and IncidentHub is able to connect to your Atlassian account,  click on "Create a test ticket". This will create a test support ticket in your Jira Service Management space.
9. Click Save.

<figure><img src="/files/ugaE1NlYo9w2puLyyTAm" alt=""><figcaption></figcaption></figure>

## Notification Example

A Jira Service Management ticket created by IncidentHub looks like this:

<figure><img src="/files/ZCo1A7JpqSj1CV8i3tI2" alt=""><figcaption></figcaption></figure>