> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-nan-6306-mcp-tool-connections-get.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-nan-6306-mcp-tool-connections-get/tWr4dyPvQdzt43h6/api-integrations/atlassian-service-account-api-token/site_lists.png?fit=max&auto=format&n=tWr4dyPvQdzt43h6&q=85&s=049a9454bbe369c7bfd0533df84da3dc" 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-nan-6306-mcp-tool-connections-get/tWr4dyPvQdzt43h6/api-integrations/atlassian-service-account-api-token/email.png?fit=max&auto=format&n=tWr4dyPvQdzt43h6&q=85&s=5353cf88a3b3306f57fcbae32112fcaf" 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-nan-6306-mcp-tool-connections-get/tWr4dyPvQdzt43h6/api-integrations/atlassian-service-account-oauth2/create_credentials.png?fit=max&auto=format&n=tWr4dyPvQdzt43h6&q=85&s=cb51b7fdce3353d85fecb9ca6390a32f" 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-nan-6306-mcp-tool-connections-get/tWr4dyPvQdzt43h6/api-integrations/atlassian-service-account-api-token/auth_type.png?fit=max&auto=format&n=tWr4dyPvQdzt43h6&q=85&s=326e0e7982771fb2d89c587c35836bd9" 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-nan-6306-mcp-tool-connections-get/tWr4dyPvQdzt43h6/api-integrations/atlassian-service-account-oauth2/scopes.png?fit=max&auto=format&n=tWr4dyPvQdzt43h6&q=85&s=99bd89c8c176c2312213222eff25fa96" 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-nan-6306-mcp-tool-connections-get/tWr4dyPvQdzt43h6/api-integrations/atlassian-service-account-api-token/review_token.png?fit=max&auto=format&n=tWr4dyPvQdzt43h6&q=85&s=f75e21daca2c66a7efc30301dac470fd" 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-nan-6306-mcp-tool-connections-get/tWr4dyPvQdzt43h6/api-integrations/atlassian-service-account-api-token/form.png?fit=max&auto=format&n=tWr4dyPvQdzt43h6&q=85&s=198e3e37e5e241aad690e4062817131a" 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.
