> ## 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 (API Token) - How do I link my account?

## Overview

To authenticate with Atlassian using service account API tokens, you will need:

1. **Cloud ID** - Your Atlassian site Cloud ID.
2. **Service Account Email** - The email address of your Atlassian service account.
3. **API Token** - Your Atlassian service account API token.

This guide will walk you through finding your Cloud ID and creating an API token for your service account.

### Prerequisites:

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

### Instructions:

#### Step 1: Finding your Cloud ID

1. Navigate to [admin.atlassian.com](https://admin.atlassian.com).
2. If you're a member of more than one organization, select your Organization.
3. Select **Apps** > **Sites** from the main navigation.
4. Select the appropriate site as listed.

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

5. The **Cloud ID** is listed after `/s/` in your address bar. For example, if your URL is `https://admin.atlassian.com/s/1a11d016-8984-4c3e-b9ab-142dd06acb1b/access-requests`, your Cloud ID is `1a11d016-8984-4c3e-b9ab-142dd06acb1b`.

#### Step 2: Finding your Service Account Email

1. Select **Directory** > **Service accounts**.
2. Select the service account you want to use.
3. The service account email will be displayed in the service account details. It typically follows the format `bot@serviceaccount.atlassian.com` or similar.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/zLiHmsU9FfsUvP0Q/api-integrations/atlassian-service-account-api-token/email.png?fit=max&auto=format&n=zLiHmsU9FfsUvP0Q&q=85&s=450794992275a1cb61693f7135f0ac37" width="1869" height="548" data-path="api-integrations/atlassian-service-account-api-token/email.png" />

#### Step 3: Creating an API Token

1. Select **Directory** > **Service accounts**.
2. Select the service account you want to create a token for.
3. 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" />

4. Select **API token**, then select **Next**.

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

5. Give your API token a name that describes what it does. Select an expiration date for the API token (token expiration can be between 1 and 365 days). Select **Next**.
6. Select scopes to determine what the API token can do in Jira or Confluence. 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 API token, then select **Create**.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/zLiHmsU9FfsUvP0Q/api-integrations/atlassian-service-account-api-token/review_token.png?fit=max&auto=format&n=zLiHmsU9FfsUvP0Q&q=85&s=8dfbfda385649eeb006555e1b3254fc1" width="1869" height="551" data-path="api-integrations/atlassian-service-account-api-token/review_token.png" />

8. Select **Copy to clipboard**, and save it somewhere safe.

<Tip>Store your API token securely. You can't recover the API token after completing this step.</Tip>

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

Once you have your **Cloud ID**, **Service Account Email**, and **API Token**:

1. Open the form where you need to authenticate with Atlassian Service Account (API Token).
2. Enter your **Cloud ID**, **Service Account Email**, and **API Token** 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-api-token/form.png?fit=max&auto=format&n=zLiHmsU9FfsUvP0Q&q=85&s=7cba79b0a8cae2e15588e23605031236" style={{maxWidth: "450px" }} width="500" height="698" data-path="api-integrations/atlassian-service-account-api-token/form.png" />

You are now connected to Atlassian using service account API tokens.
