> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-integration-config-credentials-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Atlassian Service Account (OAuth 2.0) - How do I link my account?

## Overview

To authenticate with Atlassian using OAuth 2.0 service account credentials, you will need:

1. **Client ID** - The OAuth 2.0 client ID from your service account credential.
2. **Client Secret** - The OAuth 2.0 client secret from your service account credential.
3. **Subdomain** (optional) - Your Atlassian account subdomain.

This guide will walk you through creating OAuth 2.0 credentials for your service account and finding your subdomain.

### Prerequisites:

* You must have an Atlassian account with admin access
* You must have created a service account

### Instructions:

#### Step 1: Creating OAuth Client Credentials

1. Go to **Atlassian Administration**. Select your organization if you have more than one.
2. Select **Directory** > **Service accounts**.
3. Select the service account you want to create a credential for.
4. Select **Create credentials**.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/zLiHmsU9FfsUvP0Q/api-integrations/atlassian-service-account-oauth2/create_credentials.png?fit=max&auto=format&n=zLiHmsU9FfsUvP0Q&q=85&s=ea142414d8f62560b7b2d06ede6c0d98" width="1914" height="572" data-path="api-integrations/atlassian-service-account-oauth2/create_credentials.png" />

5. Select **OAuth 2.0**, then select **Next**.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/zLiHmsU9FfsUvP0Q/api-integrations/atlassian-service-account-oauth2/auth_types.png?fit=max&auto=format&n=zLiHmsU9FfsUvP0Q&q=85&s=3a1787cc02c6c8c15d07c0c859d7225f" width="1914" height="572" data-path="api-integrations/atlassian-service-account-oauth2/auth_types.png" />

6. Select scopes to determine what the API access token can do in Atlassian. Select **Next**.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/zLiHmsU9FfsUvP0Q/api-integrations/atlassian-service-account-oauth2/scopes.png?fit=max&auto=format&n=zLiHmsU9FfsUvP0Q&q=85&s=62d3b67df56e006f7936103979da9238" width="1914" height="814" data-path="api-integrations/atlassian-service-account-oauth2/scopes.png" />

7. Review your OAuth information, then select **Create**.
8. Copy your **Client ID** and **Client Secret** and save them somewhere safe. You can't recover them after you create the credential.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/zLiHmsU9FfsUvP0Q/api-integrations/atlassian-service-account-oauth2/credentials.png?fit=max&auto=format&n=zLiHmsU9FfsUvP0Q&q=85&s=d70057852ab794a954be2b0ab41d94cd" width="1914" height="367" data-path="api-integrations/atlassian-service-account-oauth2/credentials.png" />

<Tip>Store your Client ID and Client Secret securely. If you lose them, you'll need to create new credentials.</Tip>

#### Step 2: Finding your Subdomain

1. Log in to your Atlassian cloud site.
2. Once logged in, check the address bar in your browser. Your subdomain is the text between `https://` and `.atlassian.net` in the URL.
   * For example, if your URL is `https://acme.atlassian.net`, your subdomain is `acme`.

<Note>The subdomain is optional. Since a single access token can have access to many resources, you can either provide a `Subdomain` during connection creation (recommended) to ensure you connect to a specific Atlassian site, or let Nango auto-select the first available site if no `Subdomain` is specified. Adding the subdomain ensures you connect to the intended site.</Note>

#### Step 3: Enter credentials in the Connect UI

Once you have your **Client ID** and **Client Secret** (and optionally your **Subdomain**):

1. Open the form where you need to authenticate with Atlassian Service Account (OAuth 2.0).
2. Enter your **Subdomain**, **Client ID**, and **Client Secret** in their respective fields.
3. Submit the form, and you should be successfully authenticated.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/zLiHmsU9FfsUvP0Q/api-integrations/atlassian-service-account-oauth2/form.png?fit=max&auto=format&n=zLiHmsU9FfsUvP0Q&q=85&s=2499fbe361c6bf01604d1b95b87c56b7" style={{maxWidth: "450px" }} width="501" height="698" data-path="api-integrations/atlassian-service-account-oauth2/form.png" />

You are now connected to Atlassian using OAuth 2.0 service account credentials.
