> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-get-deployments-docs.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-marcin-get-deployments-docs/VQPEYczYkyQcDMBH/api-integrations/atlassian-service-account-api-token/site_lists.png?fit=max&auto=format&n=VQPEYczYkyQcDMBH&q=85&s=4f36fa13d23a8b34a3e98c2ea1308cbf" 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-marcin-get-deployments-docs/VQPEYczYkyQcDMBH/api-integrations/atlassian-service-account-api-token/email.png?fit=max&auto=format&n=VQPEYczYkyQcDMBH&q=85&s=8ade55580bcb4fea48c373667d4cb9b3" 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-marcin-get-deployments-docs/VQPEYczYkyQcDMBH/api-integrations/atlassian-service-account-oauth2/create_credentials.png?fit=max&auto=format&n=VQPEYczYkyQcDMBH&q=85&s=7952d67352f354bfa8e3787654501d90" 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-marcin-get-deployments-docs/VQPEYczYkyQcDMBH/api-integrations/atlassian-service-account-api-token/auth_type.png?fit=max&auto=format&n=VQPEYczYkyQcDMBH&q=85&s=32603a945601bc93d7c524b0972755fe" 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-marcin-get-deployments-docs/VQPEYczYkyQcDMBH/api-integrations/atlassian-service-account-oauth2/scopes.png?fit=max&auto=format&n=VQPEYczYkyQcDMBH&q=85&s=5bcd166cef2dfaae4b1555824b6e495a" 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-marcin-get-deployments-docs/VQPEYczYkyQcDMBH/api-integrations/atlassian-service-account-api-token/review_token.png?fit=max&auto=format&n=VQPEYczYkyQcDMBH&q=85&s=5a5425802475254a44ee744d1a1c363a" 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-marcin-get-deployments-docs/VQPEYczYkyQcDMBH/api-integrations/atlassian-service-account-api-token/form.png?fit=max&auto=format&n=VQPEYczYkyQcDMBH&q=85&s=6df4abaddc3613b7d9a14e43e60c7dc9" 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.
