# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.incidenthub.cloud/incidenthub-documentation/channels/integration-for-atlassian-jira-service-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.