> ## 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.

# Kandji - How do I link my account?

# Overview

To authenticate with Kandji, you need two key pieces of information:

1. **Subdomain** - The subdomain to your Kandji instance.
2. **API Token** - A key that grants Nango permission to interact with Kandji's APIs resources and services.

This guide will walk you through obtaining both the API Token and Subdomain within Kandji.

### Prerequisites:

* You must have a Kandji account.

### Instructions:

#### Step 1: Finding Your Subdomain

1. Login to your [Kandji](https://www.kandji.io/login/) account.
2. Navigate to **Settings** > **Access**.
3. Scroll to the bottom of the page to find the **API Token** section. Your **Subdomain** is the text that appears before `.kandji.io`. In the example below, the Subdomain is `nango.api`.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/DVrtJn_EDMUDVpWS/integrations/all/kandji/subdomain.png?fit=max&auto=format&n=DVrtJn_EDMUDVpWS&q=85&s=2076051fdc6919f948bcacbfa0cd2d68" width="3024" height="1370" data-path="integrations/all/kandji/subdomain.png" />

#### Step 2: Generating Your API Token

1. Within the same **API Token** section, click the **Add API Token** button to create a new **API Token**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/DVrtJn_EDMUDVpWS/integrations/all/kandji/generate_api_key.png?fit=max&auto=format&n=DVrtJn_EDMUDVpWS&q=85&s=5eb757dc065565387e9510701b58ba20" width="3024" height="1458" data-path="integrations/all/kandji/generate_api_key.png" />

2. Provide a **Name** and **Description** for your **API Token**.
3. Click **Create**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/DVrtJn_EDMUDVpWS/integrations/all/kandji/create_key_form.png?fit=max&auto=format&n=DVrtJn_EDMUDVpWS&q=85&s=2f81809c21718a24664f71572ab1b84b" width="3024" height="1458" data-path="integrations/all/kandji/create_key_form.png" />

4. Kandji will display a modal with the **API Token**. Click the visibility symbol to expose it or use the **Copy Token** button to copy the **API Token** to your clipboard.
5. Check the **I have copied** checkbox and click **Next**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/DVrtJn_EDMUDVpWS/integrations/all/kandji/generated_key.png?fit=max&auto=format&n=DVrtJn_EDMUDVpWS&q=85&s=7e1938ac0d0e9c5cdfe198e900d1fc06" width="3024" height="1458" data-path="integrations/all/kandji/generated_key.png" />

6. Click **Configure** to manage the API permissions for this specific token or **Skip** to change them later.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/DVrtJn_EDMUDVpWS/integrations/all/kandji/manage_form.png?fit=max&auto=format&n=DVrtJn_EDMUDVpWS&q=85&s=c8eb17eb71576c4df1fa5b2f67366c66" width="3024" height="1392" data-path="integrations/all/kandji/manage_form.png" />

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/DVrtJn_EDMUDVpWS/integrations/all/kandji/permissions.png?fit=max&auto=format&n=DVrtJn_EDMUDVpWS&q=85&s=07cc1877e23b3183bed1b4c1c8094302" width="3024" height="1458" data-path="integrations/all/kandji/permissions.png" />

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

Once you have both the **Subdomain** and **API Token**:

1. Open the form where you need to authenticate with Kandji.
2. Enter your **Subdomain** 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/DVrtJn_EDMUDVpWS/integrations/all/kandji/form.png?fit=max&auto=format&n=DVrtJn_EDMUDVpWS&q=85&s=c99fcd4f27b830e6932b46c99fab73c9" style={{maxWidth: "450px" }} width="1000" height="1384" data-path="integrations/all/kandji/form.png" />

You are now connected to Kandji.
