How to create Oauth2 credentials for Jira

In this guide, we’ll walk through creating OAuth2 credentials in Jira (Atlassian Developer Console) and connecting them to Composio. Let’s get started!!

Step 1: Log in to Atlassian Developer Console

1. Open the Atlassian Developer Console.

2. Log in with your Jira/Atlassian account.

   • If you don’t have one, you can sign up for free.

Step 2: Create a New OAuth2 App

1. On the dashboard, click Create App.

2. Select OAuth 2.0 (3LO).

3. Fill in your app details:

   • App Name → e.g., Composio Jira Integration

   

   • Redirect URL → paste this exact value:

   <https://backend.composio.dev/api/v1/auth-apps/add>
   

   • Permissions (Scopes) → choose according to what you want Composio to access (commonly):

     • read:jira-user

     • read:jira-work

     • write:jira-work

You can adjust scopes later if you need more/less access.

Click Save.

Step 3: Retrieve Your OAuth Credentials

Once the app is created:

1. Go to the Settings page of your new app.

2. Copy these values:

   • Client ID

   • Client Secret

Store the secret safely — you’ll need it in Composio.

Step 4: Add OAuth Config in Composio

Now, let’s connect Jira to Composio.

1. Open the Composio Dashboard.

2. Go to Auth Configs → Create Auth Config.

   

3. From the list, choose Jira.

4. Set the authentication type to OAuth2.

Fill in the details:

Choose OAuth2 and add the necessary scopes as added in Jira

• Client ID → paste the Jira client ID

• Client Secret → paste the Jira client secret

• Redirect URI →

  <https://backend.composio.dev/api/v3/auth-apps/add>

• Token URL →

  <https://auth.atlassian.com/oauth/token>

• Scopes → the scopes you selected earlier (read:jira-work, write:jira-work, etc.)

Click Create Auth Config

Base URL for Jira

When making API requests via this config, Jira endpoints look like this:

<https://api.atlassian.com/ex/jira/><cloudid>

Replace <cloudid> with your Jira Cloud site ID (you can find it in your Atlassian Developer Console).

That’s it! You’ve successfully created OAuth2 credentials for Jira and connected them to Composio.