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

# 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/sxsjZH_tDFE3XyIS/api-integrations/zendesk-api-key/allow_api_token.png?fit=max&auto=format&n=sxsjZH_tDFE3XyIS&q=85&s=49e25e67689b2418c6bc104cf1336a24" 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/sxsjZH_tDFE3XyIS/api-integrations/zendesk-api-key/generate_api_token.png?fit=max&auto=format&n=sxsjZH_tDFE3XyIS&q=85&s=bac9b7cfd7c5d43cfafde869f407238e" width="1921" height="822" data-path="api-integrations/zendesk-api-key/generate_api_token.png" />

<img src="https://mintcdn.com/nango/sxsjZH_tDFE3XyIS/api-integrations/zendesk-api-key/generated_api_key.png?fit=max&auto=format&n=sxsjZH_tDFE3XyIS&q=85&s=6e8bbcadc18c5406347b7972ce47c571" 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/sxsjZH_tDFE3XyIS/api-integrations/zendesk-api-key/form.png?fit=max&auto=format&n=sxsjZH_tDFE3XyIS&q=85&s=fbbc67a2552638743bd839c84473c4a1" width="500" height="700" data-path="api-integrations/zendesk-api-key/form.png" />

You are now connected to Zendesk.
