> ## 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 Cloud Admin - How do I link my account?

# Overview

To authenticate with Atlassian Cloud Admin, you will need:

1. **API Key** - A key that grants Nango permission to interact with Atlassian Cloud Admin APIs resources and services.
2. **Organization ID** - ID that is associated with your Atlassian organization. This is optional.

This guide will walk you through generating your **API Key** and finding your **Organization ID** within Atlassian.

### Prerequisites:

* You must have an account with Atlassian.

#### Step 1 Generating your API Key

* To authenticate with Atlassian Cloud Admin APIs, you’ll need to generate an API key. You can choose between:

- **API key with scopes** – More secure, allows fine-grained access control.
- **API key without scopes** – Broader access, potentially less secure.

1. Go to [https://admin.atlassian.com](https://admin.atlassian.com).
2. Select your organization (if you have more than one).
3. Navigate to **Settings** > **API keys**.
4. If this is your first **API key**, click **Create your API Key**. If you've already created **API keys** before, click **Create API key** in the top-right corner of the page.

<img src="https://mintcdn.com/nango-marcin-nan-6306-mcp-tool-connections-get/nZ-GzTGHm0jYO5LB/integrations/all/atlassian-admin/create_api_key.png?fit=max&auto=format&n=nZ-GzTGHm0jYO5LB&q=85&s=4abd2852313518a0f9811c9ecf8cdd42" width="3024" height="1296" data-path="integrations/all/atlassian-admin/create_api_key.png" />

<img src="https://mintcdn.com/nango-marcin-nan-6306-mcp-tool-connections-get/nZ-GzTGHm0jYO5LB/integrations/all/atlassian-admin/create_api_key2.png?fit=max&auto=format&n=nZ-GzTGHm0jYO5LB&q=85&s=402c95493c4e9a15160b944e2bfe69a7" width="3024" height="1272" data-path="integrations/all/atlassian-admin/create_api_key2.png" />

4. Choose one of the following options:
   * **To create a scoped key**: Click **API keys with scopes**, then click **Next**.
   * **To create an unscoped key**: Click **API keys without scopes**, then **Next**.

<img src="https://mintcdn.com/nango-marcin-nan-6306-mcp-tool-connections-get/nZ-GzTGHm0jYO5LB/integrations/all/atlassian-admin/scope_api_key.png?fit=max&auto=format&n=nZ-GzTGHm0jYO5LB&q=85&s=4d556f0d500a373dd15a33a9bac76b3f" width="3024" height="1066" data-path="integrations/all/atlassian-admin/scope_api_key.png" />

5. Enter a **Name** for the key that helps identify its purpose (e.g., `"User Sync Script"`).
6. Select an **Expiration Date** (API keys can last a maximum of **1 year**).

<img src="https://mintcdn.com/nango-marcin-nan-6306-mcp-tool-connections-get/nZ-GzTGHm0jYO5LB/integrations/all/atlassian-admin/key_name.png?fit=max&auto=format&n=nZ-GzTGHm0jYO5LB&q=85&s=6a24eaaa51379f5bdc33c5d233af9c4b" width="3024" height="1066" data-path="integrations/all/atlassian-admin/key_name.png" />

7. (For scoped keys only) Under **Select scopes**, choose the appropriate [permissions](https://developer.atlassian.com/cloud/admin/scopes/) for your use case.

<img src="https://mintcdn.com/nango-marcin-nan-6306-mcp-tool-connections-get/nZ-GzTGHm0jYO5LB/integrations/all/atlassian-admin/scopes.png?fit=max&auto=format&n=nZ-GzTGHm0jYO5LB&q=85&s=378a46b170660abb70daa3a2cb36682d" width="3024" height="1492" data-path="integrations/all/atlassian-admin/scopes.png" />

8. Review all details and selected scopes (if applicable).

<img src="https://mintcdn.com/nango-marcin-nan-6306-mcp-tool-connections-get/nZ-GzTGHm0jYO5LB/integrations/all/atlassian-admin/review_key_details.png?fit=max&auto=format&n=nZ-GzTGHm0jYO5LB&q=85&s=e6be25cd0f2b0d727a201e34d21aecff" width="3024" height="1486" data-path="integrations/all/atlassian-admin/review_key_details.png" />

9. Click **Create API Key**.
10. Copy and securely save the **API Key** when prompted — you won’t be able to view it again later.
11. Copy and save the **Organization ID**. You can optionally enter this in the Connect UI.

#### Step 2 Enter credentials in the Connect UI

Once you have your **API Key**:

1. Open the form where you need to authenticate with Atlassian Cloud Admin.
2. Enter your **API Key** in its respective field.
3. Optionally enter your **Organization ID** in the correct field.
4. Submit the form, and you should be successfully authenticated.

<img src="https://mintcdn.com/nango-marcin-nan-6306-mcp-tool-connections-get/nZ-GzTGHm0jYO5LB/integrations/all/atlassian-admin/form.png?fit=max&auto=format&n=nZ-GzTGHm0jYO5LB&q=85&s=f55356bb1bf71b28429b2899f90382c8" style={{maxWidth: "450px" }} width="498" height="694" data-path="integrations/all/atlassian-admin/form.png" />

You are now connected to Atlassian Cloud Admin.
