> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-migrated-bigcommerce-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-wari-migrated-bigcommerce-docs/QWtVAOVY-PHYzt9X/integrations/all/kandji/subdomain.png?fit=max&auto=format&n=QWtVAOVY-PHYzt9X&q=85&s=bb392536d86599e99471394a9492854e" 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-wari-migrated-bigcommerce-docs/QWtVAOVY-PHYzt9X/integrations/all/kandji/generate_api_key.png?fit=max&auto=format&n=QWtVAOVY-PHYzt9X&q=85&s=8d572adb2b820413ddbc08f7ed64ab39" 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-wari-migrated-bigcommerce-docs/QWtVAOVY-PHYzt9X/integrations/all/kandji/create_key_form.png?fit=max&auto=format&n=QWtVAOVY-PHYzt9X&q=85&s=8a7dc2cd8353007e99abf3e8181e7b3c" 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-wari-migrated-bigcommerce-docs/QWtVAOVY-PHYzt9X/integrations/all/kandji/generated_key.png?fit=max&auto=format&n=QWtVAOVY-PHYzt9X&q=85&s=b7a46f1d082f61ed11a0de8f85b2a0bc" 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-wari-migrated-bigcommerce-docs/QWtVAOVY-PHYzt9X/integrations/all/kandji/manage_form.png?fit=max&auto=format&n=QWtVAOVY-PHYzt9X&q=85&s=f8d0827120714a7d59d43f1dd830adaa" width="3024" height="1392" data-path="integrations/all/kandji/manage_form.png" />

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/QWtVAOVY-PHYzt9X/integrations/all/kandji/permissions.png?fit=max&auto=format&n=QWtVAOVY-PHYzt9X&q=85&s=dd1ceb0d8273f0c694155a4c1fd46cd5" 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-wari-migrated-bigcommerce-docs/QWtVAOVY-PHYzt9X/integrations/all/kandji/form.png?fit=max&auto=format&n=QWtVAOVY-PHYzt9X&q=85&s=7c306071ff4ad39fe498a45dfb207979" style={{maxWidth: "450px" }} width="1000" height="1384" data-path="integrations/all/kandji/form.png" />

You are now connected to Kandji.
