# JIRA Software

{% hint style="warning" %}
Integrations is a part of the Custom plan. Additional cost might apply.  
{% endhint %}

The JIRA integration aligns Suptask ticketing with agile project management and development issue tracking, providing a seamless link between support and development. This ensures tickets needing engineering support are efficiently tracked and resolved.

\
**Use Cases with Suptask:**

* Automatically create Jira issues for tickets that need development work.
* Sync ticket updates with Jira to keep teams up to date.
* Enrich tickets with ticket details for broader project visibility.

***

### Requirements

You need a JIRA Software Cloud account in order to set up the integration. 

#### Setup communication to JIRA

1. Log in to your Atlassian profile and navigate to **Security > API Tokens.**
2. Click on **Create API Token**.
3. Provide a descriptive label for your token, such as **Suptask Integration**.
4. Click **Create** to generate the token.
5. Copy the API token that is displayed.
6. Share the **API token** securely with the Suptask Integrations Specialist (SIS) contact
   1. Include the **Email address** linked to the token and the corresponding **Domain** e.g:\
      <first.last@mydomain.com>\
      <https://mydomain.atlassian.net>

#### Setup communication from JIRA

1. In JIRA, open the JIRA **Settings** in the upper right corner (on the cog-icon)
2. Select **System**
3. In the Advanced section in the left menu, open the **WebHooks** item &#x20;
4. **Create a new WebHook**&#x20;
   1. **Name**: Suptask - New Comment
   2. **URL**: `https://...` (this is shared to you from the Suptask Integrations Specialist (SIS) contact)
   3. Select the following Events: **Comment Created + Updated**&#x20;
5. **Save**&#x20;

{% hint style="info" %}
The integration will be enabled for an Inbox, or for a particular Form of your choice.
{% endhint %}

***

### Example of how it works&#x20;

1. Ticket in Suptask is created&#x20;
2. Team of Agents decide to escalate to JIRA for further development work.&#x20;
   1. The creation to JIRA can also happen automatically for every created Suptask ticket in your Inbox, this is customizable.&#x20;
3. Ticket is automatically created in JIRA from Suptask, where the Suptask ticket is connected to the JIRA issue.&#x20;
4. Actions, replies and comments are automatically synced bi-directionally.&#x20;
   1. For example, status changes can be aligned between the systems
5. Agents in Suptask can reply on tickets directly in Slack.

&#x20;**Example view from JIRA:**

<figure><img src="/files/U8VUkUyQ6Kw2PsdejB0k" alt=""><figcaption><p>Example how replies in Slack can look in JIRA via Suptask </p></figcaption></figure>

&#x20;**Example view from Suptask in Slack:**

<figure><img src="/files/4RE760dBfhRjRlzNV15S" alt=""><figcaption><p>Example of the view in Suptask with the connect JIRA issue</p></figcaption></figure>

***

### How to get started

The JIRA integration is setup and enabled together with the Suptask Integrations Specialists (SIS).

{% hint style="info" %}
Contact [Suptask Support](/getting-started/contact-support.md) for more information and to get started.&#x20;
{% endhint %}


---

# 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://support.suptask.com/integrations-automations-and-workflows/integration-guides/jira-software.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.