Skip to content
Last updated

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 and sign in with your Atlassian account.

Atlassian Developer Console showing the list of existing apps

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

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

Create dialog with name entered and terms accepted

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

Step 5: Copy your credentials

Navigate to Settings to find your Client ID and Secret.

App Settings page showing Client ID and Secret fields

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

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:

ScopeDescription
read:jira-workRead Jira project and issue data, search for issues, and objects associated with issues
manage:jira-projectCreate and edit project settings and create new project-level objects
read:jira-userView user information in Jira that the user has access to
write:jira-workCreate and edit issues in Jira, post comments, create worklogs, and delete issues

Click Save.

Edit Jira platform REST API dialog with four scopes selected

Jira API scopes page showing 4 scopes configured

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

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

Click Save changes.

Authorization page after saving, showing the saved callback URLs

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