> ## Documentation Index
> Fetch the complete documentation index at: https://nango-scrips-ref.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 CRM, reach out or contribute it :)
</Note>

## Features

| Features                                                             | Status                         |
| -------------------------------------------------------------------- | ------------------------------ |
| [Auth (OAuth)](/integrate/guides/authorize-an-api)                   | ✅                              |
| [Sync data](/integrate/guides/sync-data-from-an-api)                 | ✅                              |
| [Perform workflows](/integrate/guides/perform-workflows-with-an-api) | ✅                              |
| [Proxy requests](/integrate/guides/proxy-requests-to-an-api)         | ✅                              |
| [Receive webhooks](/integrate/guides/receive-webhooks-from-an-api)   | 🚫 (time to contribute: \<48h) |

<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](/integrate/guides/authorize-an-api#apis-requiring-connection-specific-configuration-for-authorization).

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