## Jira integration

Jira is a project management and issue tracking platform by Atlassian used for planning, tracking, and releasing software. The Jira integration with Frontegg allows your application to access and manage Jira issues, projects, and user data on behalf of your users.

Prerequisites
- An Atlassian account with access to the Atlassian Developer Console
- Permission to create OAuth 2.0 apps in the Atlassian Developer Console


### Connect Jira

#### Step 1: Open the Atlassian Developer Console

Go to [developer.atlassian.com/console/myapps](https://developer.atlassian.com/console/myapps/) and sign in with your Atlassian account.

![Atlassian Developer Console showing the list of existing apps](/assets/jira-1.0c94a271d7d8745df78b831b879f64db333dd9949705e7e9cf8802a4358b37dc.1ce25488.png)

#### Step 2: Create a new OAuth 2.0 app

Click **Create** and select **OAuth 2.0 integration** from the dropdown.

![Create dropdown with OAuth 2.0 integration option highlighted](/assets/jira-2.96e579373253635f571cc131c847e7387ce691a4b6fda08497a371098dd73dc1.1ce25488.png)

#### Step 3: Fill in the app details

In the dialog that appears, enter the app name and accept the terms:

- **App name**: `Frontegg Integration`
- Check **I agree to the Atlassian developer terms**


Click **Create**.

![Create a new OAuth 2.0 integration dialog with app name filled in](/assets/jira-3.8be712653d9c415cdcb0e82ab6d57f011fad91507d15305ccfad6461c64808e8.1ce25488.png)

![Create dialog with name entered and terms accepted](/assets/jira-4.1ce84d7b592db688f48bfc28dd1840feb146d3f99260aae9df08a4b07c4dcdec.1ce25488.png)

#### Step 4: View the app overview

After creation, you are taken to the app overview page. This shows your app's details and navigation tabs.

![Frontegg Integration app overview page](/assets/jira-5.2b4d5b8d3c8db2d48b5e927b35ba79389636c4423f0a6940eae9a93d888f8440.1ce25488.png)

#### Step 5: Copy your credentials

Navigate to **Settings** to find your **Client ID** and **Secret**.

![App Settings page showing Client ID and Secret fields](/assets/jira-6.56912e0ee1a7896bd1fcb3b9f17ba6526190f31e6b6a8ba83a1e858b91329830.1ce25488.png)

Save your Secret now
Copy the Secret immediately and store it securely. You will need it when configuring the Frontegg portal.

#### Step 6: Add the Jira API permission

Navigate to the **Permissions** tab. In the API list, find **Jira API** and click **Add**.

![Permissions page with Jira API row and Add button highlighted](/assets/jira-7.d6931bea19a948f2901e4ff13d6a81080fec3ed486f9ad8cf3116a69c8e5eb54.1ce25488.png)

#### Step 7: Configure Jira API scopes

After adding the Jira API, click **Configure** next to it. On the scopes page, click **Edit Scopes** under **Jira platform REST API**.

In the dialog, select the following scopes:

| Scope | Description |
|  --- | --- |
| `read:jira-work` | Read Jira project and issue data, search for issues, and objects associated with issues |
| `manage:jira-project` | Create and edit project settings and create new project-level objects |
| `read:jira-user` | View user information in Jira that the user has access to |
| `write:jira-work` | Create and edit issues in Jira, post comments, create worklogs, and delete issues |


Click **Save**.

![Edit Jira platform REST API dialog with four scopes selected](/assets/jira-8.d5b4e568fa46f47e4d3a07753069c4a64e75c5b3655ef412ea0c5bec18742e14.1ce25488.png)

![Jira API scopes page showing 4 scopes configured](/assets/jira-9.51360b03c9b265b2a61dbdf127d5de8663f8c01ebe0869ea0c5cd8c4da918883.1ce25488.png)

#### Step 8: Configure the callback URL

Navigate to the **Authorization** tab and click **Add** next to **OAuth 2.0 (3LO)**.

![Authorization tab showing OAuth 2.0 (3LO) row with Add button highlighted](/assets/jira-10.a3176422ab63640a40517146702e49f77e64123bb2e51b37a4c838dd7b8de4b6.1ce25488.png)

In the **Callback URLs** field, enter the following URLs, one per line:


```
https://YOUR_MCP_GATEWAY_URL/integration-callback
```

![Authorization page with Frontegg callback URLs entered in the Callback URLs field](/assets/jira-12.93eef21696aaa62c3598780727d7a672cada9b587d3d80ac9041e453a034afa1.1ce25488.png)

Click **Save changes**.

![Authorization page after saving, showing the saved callback URLs](/assets/jira-13.2b4132f6f07e68fc3a8e54c25c2352aabe7c74b9b84237cc3f7d5b07ad11f19d.1ce25488.png)

### Configure the Frontegg portal

Once you have your **Client ID** and **Secret** from the Settings page, enter them in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Jira.
2. Enter the **Client ID** and **Secret** in the corresponding fields.
3. Click **Save**.


Keep your credentials secure
Never share or commit your Secret to version control.

### Additional resources

- [Jira Cloud REST API documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/)
- [Atlassian OAuth 2.0 (3LO) guide](https://developer.atlassian.com/cloud/jira/platform/oauth-2-authorization-code-grants-3lo-for-apps/)
- [Atlassian Developer Console](https://developer.atlassian.com/console/myapps/)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)