> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-integration-config-credentials-api.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-integration-config-credentials-api/kipYoneMriaWnwwA/integrations/all/kandji/subdomain.png?fit=max&auto=format&n=kipYoneMriaWnwwA&q=85&s=70933a934b17a2b6f3ea84577bbf5645" 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-integration-config-credentials-api/kipYoneMriaWnwwA/integrations/all/kandji/generate_api_key.png?fit=max&auto=format&n=kipYoneMriaWnwwA&q=85&s=020355dc64d80fbb9b8644c5b77d2801" 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-integration-config-credentials-api/kipYoneMriaWnwwA/integrations/all/kandji/create_key_form.png?fit=max&auto=format&n=kipYoneMriaWnwwA&q=85&s=f7629ba7b295747f71fcbbd0a1c83eb5" 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-integration-config-credentials-api/kipYoneMriaWnwwA/integrations/all/kandji/generated_key.png?fit=max&auto=format&n=kipYoneMriaWnwwA&q=85&s=519976ee27aa4a36a744af55affd51f6" 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-integration-config-credentials-api/kipYoneMriaWnwwA/integrations/all/kandji/manage_form.png?fit=max&auto=format&n=kipYoneMriaWnwwA&q=85&s=fcd5abbfcaf157af2059f0c80e34f0e5" width="3024" height="1392" data-path="integrations/all/kandji/manage_form.png" />

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/kipYoneMriaWnwwA/integrations/all/kandji/permissions.png?fit=max&auto=format&n=kipYoneMriaWnwwA&q=85&s=b45208e5c167b9ea694fefcb8ced8626" 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-integration-config-credentials-api/kipYoneMriaWnwwA/integrations/all/kandji/form.png?fit=max&auto=format&n=kipYoneMriaWnwwA&q=85&s=ab147b8f8e634f9d804f772878766e16" style={{maxWidth: "450px" }} width="1000" height="1384" data-path="integrations/all/kandji/form.png" />

You are now connected to Kandji.
