# Jira

### Register OAuth app

You can find all the necessary information on how to register an OAuth app in Jira in their [official guide](https://developer.atlassian.com/cloud/oauth/getting-started/managing-oauth-apps/).

Access [Attlassian Developer Console](https://developer.atlassian.com/console/myapps/) and create a new app. Click Create and select OAuth 2.0 integration.

Click on the "Register an app" button.

#### Specify scopes

You need to specify the scopes that your app will use. For Jira, you will need to select the following scopes:

* read:me
* read:jira-work
* write:jira-work
* manage:jira-project
* manage:jira-configuration
* read:jira-user
* report:personal-data

This is how the permissions should look like:

<figure><img src="https://content.gitbook.com/content/cfhstxIZQWZNvWjV2O6F/blobs/202aERXSZgDUB9d39mE9/jira-2.png" alt=""><figcaption><p>Specify scopes</p></figcaption></figure>

#### Specify Callback URL

<figure><img src="https://content.gitbook.com/content/cfhstxIZQWZNvWjV2O6F/blobs/aK0rWVozQa9HrJc6e7sB/jira-4.png" alt=""><figcaption><p>Specify callback URL</p></figcaption></figure>

#### Overview

After you have created the app, you will see the overview of the app. Here you can find the client ID and client secret.

<figure><img src="https://content.gitbook.com/content/cfhstxIZQWZNvWjV2O6F/blobs/JCM5xcxudK7TkwjHPEyk/jira-3.png" alt=""><figcaption><p>Settings with clientId and clientSecret</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/cfhstxIZQWZNvWjV2O6F/blobs/jzVb5sk5d3BZ5xxy5vkk/jira-1.png" alt=""><figcaption><p>Overview of the new app</p></figcaption></figure>

#### Set `clientId`, `clientSecret` into Appmixer Backoffice.

The last step is to configure clientId and clientSecret in the Appmixer Backoffice for `appmixer:jira` connector.

<figure><img src="https://content.gitbook.com/content/cfhstxIZQWZNvWjV2O6F/blobs/jbAmlEcnhChyIr8uJx2s/jira-5.png" alt=""><figcaption><p>Backoffice JIRA connector configuration</p></figcaption></figure>