Overview

This guide will walk you through the steps generate your client credentials within Jira and input them into the Merge Dashboard. Please note that generating your own client credentials is not required for the Jira connector to work, but is required in order to use the OAuth2 flow.

Instructions

Step 1: Create a Jira app

1. Navigate to the Atlassian Developer console.

   1. You must have an Atlassian developer account in order to create an OAuth application.

2. Select the "Create" button, and pick "OAuth 2.0 integration" from the dropdown.

   

3. Complete the app creation form

   1. App Name: give you app a name that references your business (e.g. "Acme Co Agentic Connector")

4. From the Distribution page

   1. Set the distribution status to "Sharing"

   2. For the Vendor Name, select "Use your own name"

   3. For the "Privacy policy", "Terms of service", and "Customer support contact" fields, enter appropriate values for your organization.

   4. Set the "Personal Data Declaration" setting to "No".

      

5. From the Authorization page

   1. Set the Callback URL "https://ah.merge.dev/oauth/callback"

6. From the Permissions page

   1. Select "Add" for the Jira product

   2. 

   3. Select the following scopes:

      1. View Jira issue data

      2. Manage project settings

      3. Manage Jira global settings

      4. View user profiles

      5. Create and manage issues

         

7. Navigate to the settings page

   1. Copy your client ID and secret

      

8. From the Agent Handler Connectors page, add your client ID and secret to the Jira connector by clicking the "+ Add connector" button