> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectstrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zendesk

> Provider ID: `Zendesk`

## Getting Started

You can connect to the Zendesk API using an API token or an OAuth app. For connecting a single Zendesk account, we recommend using an API token.

### API Token Setup

<Steps>
  <Step title="Generate a Zendesk API Token">
    In Admin Center, click **Apps and integrations** in the sidebar, then select **APIs > API tokens**. Click **Add API token**, enter an optional description (e.g. `Strata Integration`), then click **Save**.

    Copy the token and store it in a secure location.

    <Note>
      You must be an administrator and API token access must be enabled on your account. The full token is only displayed once — after closing the creation window, only a truncated version is available.
    </Note>
  </Step>

  <Step title="Configure the Zendesk Integration in Strata">
    Select Zendesk in the [Strata Integration Catalog](https://app.connectstrata.com/integrations/catalog). Enter the email address associated with your Zendesk account, your Zendesk subdomain, and the API token.
  </Step>
</Steps>

### OAuth App Setup

<Steps>
  <Step title="Create a Zendesk OAuth Client">
    In Admin Center, click **Apps and integrations** in the sidebar, then select **APIs > Zendesk API > OAuth Clients**. Click **Add OAuth Client**, enter a name, and add the Strata OAuth callback URL as a redirect URL:

    ```text theme={null}
    https://connect.connectstrata.com/oauth/callback
    ```

    Save the client and copy the **Client ID** and **Client Secret**.

    <Note>
      The client secret is only displayed once. Store it in a secure location.
    </Note>
  </Step>

  <Step title="Configure the Zendesk Integration in Strata">
    Select Zendesk in the [Strata Integration Catalog](https://app.connectstrata.com/integrations/catalog). Enter your Zendesk subdomain, OAuth client ID, client secret, and required scopes.

    <Note>
      The scopes in the Strata dashboard should match the scopes you configured in your Zendesk OAuth client.
    </Note>
  </Step>
</Steps>