> ## Documentation Index
> Fetch the complete documentation index at: https://nango-tiktok-accounts-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zendesk (Helpdesk)

API configuration: [`zendesk`](https://nango.dev/providers.yaml)

<Note>
  Zendesk has two kinds of OAuth apps:

  * Helpdesk/support apps
  * CRM apps

  Nango currently only supports OAuth for the Helpdesk apps. If you need the CRM one supported reach out or contribute it :)
</Note>

## Features

| Feature                                           | Status                        |
| ------------------------------------------------- | ----------------------------- |
| [Auth (OAuth)](/guides/oauth)                     | ✅                             |
| [Syncs](/guides/sync) & [Actions](/guides/action) | ✅                             |
| [Nango Proxy](/guides/proxy)                      | ✅                             |
| Auto-pagination                                   | 🚫 (time to contribute: \<1h) |
| API-specific rate limits                          | 🚫 (time to contribute: \<1h) |

<Tip>We can implement missing features in \<48h, just ask for it in the [community](https://nango.dev/slack).</Tip>

## Getting started

* [How to register an Application](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application#topic_s21_lfs_qk)
* [List of OAuth scopes](https://support.zendesk.com/hc/en-us/articles/4408845965210#topic_gql_kbd_gt)
* [Setting up a global oAuth client](https://developer.zendesk.com/documentation/marketplace/building-a-marketplace-app/set-up-a-global-oauth-client/)
* [API](https://developer.zendesk.com/api-reference/)

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

## Connection configuration in Nango

Zendesk requires a user specific subdomain to run OAuth.

You should request this from the user and pass it to Nango in the `nango.auth()` call:

```js
nango.auth('zendesk', '<CONNECTION-ID>', {params: {subdomain: '<zendesk-subdomain>'}});
```

For more details, see the [docs here](/guides/advanced-auth#connection-configuration).

## API gotchas

* Make sure to create a Zendesk OAuth app (`https://<USER-SUBDOMAIN>.zendesk.com/admin/apps-integrations/apis/zendesk-api/settings`), *not* a Zendesk Sales CRM OAuth app.
* Zendesk oAuth apps [must be made "global"](https://developer.zendesk.com/documentation/marketplace/building-a-marketplace-app/set-up-a-global-oauth-client/) to connect to multiple `<USER-SUBDOMAIN>`s.

<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/zendesk.mdx)</Note>
