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

# Zendesk (API token) - How do I link my account?

# Overview

To authenticate with Zendesk using an API token, you need:

1. **Subdomain** — the unique name of your Zendesk account
2. **Email address** — your Zendesk account email (e.g. `user@example.com`)
3. **API token** — a token generated in your Zendesk Admin Center

This guide will walk you through obtaining these credentials.

### Prerequisites:

* You must have a Zendesk account with API token access enabled.

### Instructions:

<a id="finding-your-subdomain" />

#### Step 1: Finding your subdomain

Your subdomain is the part of your Zendesk URL between `https://` and `.zendesk.com`. For example, if your Zendesk URL is `https://acme.zendesk.com`, your subdomain is `acme`.

#### Step 2: Enable API token access

<Note>If API token access is already enabled, skip to Step 3 below.</Note>

1. Log in to your Zendesk Admin Center.
2. Navigate to **Apps and integrations** > **APIs** > **API configuration**.
3. Toggle **Allow API token access** to enabled.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/HDUjkjftYIkgNPjA/api-integrations/zendesk-api-key/allow_api_token.png?fit=max&auto=format&n=HDUjkjftYIkgNPjA&q=85&s=527012dfa6619c5dd6de3374240cd781" width="1921" height="822" data-path="api-integrations/zendesk-api-key/allow_api_token.png" />

#### Step 3: Generate an API token

1. On the same **Apps and integrations** settings page, navigate to API Tokens, click **Add API token**.
2. Give the token a description and click **Save**.
3. Copy the token — it will only be shown once.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/I_2P2sZMaX_eVczE/api-integrations/zendesk-api-key/generate_api_token.png?fit=max&auto=format&n=I_2P2sZMaX_eVczE&q=85&s=4bc6520f238f6f0618a5cb7fa168c259" width="1921" height="822" data-path="api-integrations/zendesk-api-key/generate_api_token.png" />

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/I_2P2sZMaX_eVczE/api-integrations/zendesk-api-key/generated_api_key.png?fit=max&auto=format&n=I_2P2sZMaX_eVczE&q=85&s=3e05435d55af61c1876440870af7c9b4" width="1921" height="598" data-path="api-integrations/zendesk-api-key/generated_api_key.png" />

Note your **email address** (e.g. `user@example.com`) — the one you use to log in to Zendesk. You'll need it together with the API token to authenticate.

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

Once you have your credentials:

1. Open the form where you need to authenticate with Zendesk.
2. Enter your **Subdomain**, **Email Address**, and **API Token** in the respective fields.
3. Submit the form — you should be successfully authenticated.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/HDUjkjftYIkgNPjA/api-integrations/zendesk-api-key/form.png?fit=max&auto=format&n=HDUjkjftYIkgNPjA&q=85&s=25fa1a31aa373a67391cb4e0c8c894e1" width="500" height="700" data-path="api-integrations/zendesk-api-key/form.png" />

You are now connected to Zendesk.
