# Jira Configuration

Source: https://userguide.qualytics.io/settings/integrations/ticketing/jira/how-tos/jira-configuration/

Complete these steps in your Jira account to generate an API token and gather the values needed to connect the integration in Qualytics.

> **Info: Prerequisites**
>
> Before starting, review the [Jira Integration Requirements](https://userguide.qualytics.io/settings/integrations/ticketing/jira/deep-dive/requirements/) to ensure you have everything you need.

> **Info: Permissions**
>
> These steps are performed in your Jira account, not in Qualytics. Any Jira user with permission to manage their own API tokens and access to the target project can complete this configuration. To connect the integration in Qualytics afterward, you'll need the **Manager** or **Admin** role in Qualytics.

## Steps

### Step 1: Access Account Settings

1. Log in to your Jira account
2. Click on your profile icon in the top-right corner
3. Select **Account settings** (or **Manage account**)

![jira-open-account-settings-modal](https://userguide.qualytics.io/assets/settings/integrations/ticketing/jira/how-tos/jira-configuration/jira-open-account-settings-modal.png)

### Step 2: Navigate to Security Settings

1. In your account settings, click on the **Security** tab

![jira-click-security-tab](https://userguide.qualytics.io/assets/settings/integrations/ticketing/jira/how-tos/jira-configuration/jira-click-security-tab.png)

### Step 3: Create an API Token

1. Scroll down to find the **API token** section
2. Click on **Create and manage API tokens**

![jira-click-in-api-token](https://userguide.qualytics.io/assets/settings/integrations/ticketing/jira/how-tos/jira-configuration/jira-click-in-api-token.png)

1. Click on **Create API token**

![jira-click-in-create-api-token](https://userguide.qualytics.io/assets/settings/integrations/ticketing/jira/how-tos/jira-configuration/jira-click-in-create-api-token.png)

1. Enter a label for your token (e.g., `Qualytics Integration`)
2. Click **Create**

![jira-show-modal-api-token](https://userguide.qualytics.io/assets/settings/integrations/ticketing/jira/how-tos/jira-configuration/jira-show-modal-api-token.png)

1. Copy the generated API token from the modal.

> **Warning**
>
> Copy the generated API token immediately and store it securely (e.g., in a password manager or secrets vault). You won't be able to see it again, because Atlassian shows the token only once.

![jira-show-pat-list](https://userguide.qualytics.io/assets/settings/integrations/ticketing/jira/how-tos/jira-configuration/jira-show-pat-list.png)

### Step 4: Gather Configuration Values

Collect the following values needed for Qualytics configuration:

| Value | How to Find | Example |
| --- | --- | --- |
| **Instance URL** | Your Jira instance URL | `https://your-domain.atlassian.net` |
| **Credentials** | Email and API token combined with a colon | `user@company.com:your_api_token` |
| **Projects** | Nothing to copy here. Qualytics reads the project list from Jira with the credentials above, and you pick which ones it may use while connecting. Just decide beforehand which projects should receive tickets. | `Data Quality (DATAQ)` |

*Last updated: September 18, 2026.*
