> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/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/mML8QF2SPjr5fRd2/integrations/all/kandji/subdomain.png?fit=max&auto=format&n=mML8QF2SPjr5fRd2&q=85&s=687f7a931f94a5dbd15d352c5722beca" 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/mML8QF2SPjr5fRd2/integrations/all/kandji/generate_api_key.png?fit=max&auto=format&n=mML8QF2SPjr5fRd2&q=85&s=2a83af7a9690fde69b72c05a68f51bd7" 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/mML8QF2SPjr5fRd2/integrations/all/kandji/create_key_form.png?fit=max&auto=format&n=mML8QF2SPjr5fRd2&q=85&s=ca9db3eb6a133d6d60e6def0eb173737" 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/mML8QF2SPjr5fRd2/integrations/all/kandji/generated_key.png?fit=max&auto=format&n=mML8QF2SPjr5fRd2&q=85&s=3bdb9646eae7aeb94537bcb395dbd6f4" 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/mML8QF2SPjr5fRd2/integrations/all/kandji/manage_form.png?fit=max&auto=format&n=mML8QF2SPjr5fRd2&q=85&s=59ae9485263713c1e38e8f079d8833d4" width="3024" height="1392" data-path="integrations/all/kandji/manage_form.png" />

<img src="https://mintcdn.com/nango/mML8QF2SPjr5fRd2/integrations/all/kandji/permissions.png?fit=max&auto=format&n=mML8QF2SPjr5fRd2&q=85&s=888b4ce213674fbe04014762f3f62945" 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/mML8QF2SPjr5fRd2/integrations/all/kandji/form.png?fit=max&auto=format&n=mML8QF2SPjr5fRd2&q=85&s=b5f305452e5c1d5ee49cd5402c908b4a" style={{maxWidth: "450px" }} width="1000" height="1384" data-path="integrations/all/kandji/form.png" />

You are now connected to Kandji.
