Zendesk (Helpdesk) - Nango Docs

🚀 Quickstart

Connect to Zendesk with Nango and see data flow in 2 minutes.

Create an integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Zendesk.

Authorize Zendesk

Go to Connections -> Add Test Connection -> Authorize, then log in to Zendesk. Later, you’ll let your users do the same directly from your app.

Call the Zendesk API

Let’s make your first request to the Zendesk API (fetch a list of tickets). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/api/v2/search?query=type:ticket&per_page=10" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/api/v2/search',
    params: {
      query: 'type:ticket',
      per_page: 10
    },
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(JSON.stringify(res.data, null, 2));

Or fetch credentials dynamically via the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Zendesk Integration Guides

Nango maintained guides for common use cases.

How to register your own Zendesk OAuth app
Register an OAuth app with Zendesk and obtain credentials to connect it to Nango
How do I link my Zendesk account?
Learn how to authenticate with Zendesk and link your account

Official docs: Zendesk API documentation

🧩 Pre-built syncs & actions for Zendesk

Enable them in your dashboard. Extend and customize to fit your needs.

Articles

Function name	Description	Type	Source code
`list-articles`	List Zendesk Help Center articles with pagination	Action	🔗 Github

Groups

Function name	Description	Type	Source code
`get-group`	Retrieve a group by ID.	Action	🔗 Github
`list-groups`	List support groups	Action	🔗 Github
`groups`	Sync support groups from Zendesk.	Sync	🔗 Github

Help Center

Function name	Description	Type	Source code
`create-category`	Create a Zendesk Help Center category	Action	🔗 Github
`create-section`	Create a Zendesk Help Center section	Action	🔗 Github
`get-article`	Retrieve a Zendesk Help Center article by ID.	Action	🔗 Github

Macros

Function name	Description	Type	Source code
`list-macros`	List ticket macros available to the account	Action	🔗 Github

Organizations

Function name	Description	Type	Source code
`create-organization`	Create an organization in Zendesk Support	Action	🔗 Github
`get-organization`	Retrieve an organization by ID.	Action	🔗 Github
`list-organizations`	List organizations in Zendesk Support.	Action	🔗 Github
`update-organization`	Update an existing organization in Zendesk.	Action	🔗 Github

Ticket Fields

Function name	Description	Type	Source code
`get-ticket-field`	Retrieve a ticket field by ID.	Action	🔗 Github

Ticket Forms

Function name	Description	Type	Source code
`get-ticket-form`	Retrieve a ticket form by ID.	Action	🔗 Github
`list-ticket-forms`	List ticket forms for the account.	Action	🔗 Github

Tickets

Function name	Description	Type	Source code
`create-ticket`	Create a support ticket in Zendesk	Action	🔗 Github
`get-ticket-comments`	List comments for a ticket.	Action	🔗 Github
`get-ticket`	Retrieve a ticket by ID.	Action	🔗 Github
`list-ticket-fields`	List ticket fields for the account.	Action	🔗 Github
`list-tickets`	List tickets in Zendesk Support	Action	🔗 Github
`search-tickets`	Search tickets with Zendesk search syntax.	Action	🔗 Github
`update-ticket`	Update an existing ticket and optionally add a comment	Action	🔗 Github

Users

Function name	Description	Type	Source code
`create-user`	Create a user in Zendesk Support.	Action	🔗 Github
`delete-user`	Delete a Zendesk user	Action	🔗 Github
`get-user`	Retrieve a user by ID.	Action	🔗 Github
`list-users`	List users in Zendesk Support.	Action	🔗 Github
`update-user`	Update an existing user.	Action	🔗 Github

Views

Function name	Description	Type	Source code
`list-views`	List ticket views for the account	Action	🔗 Github

Others

Function name	Description	Type	Source code
`articles`	Sync Zendesk Help Center articles	Sync	🔗 Github
`categories`	Sync Zendesk Help Center categories	Sync	🔗 Github
`macros`	Sync ticket macros from Zendesk	Sync	🔗 Github
`organizations`	Sync organizations from Zendesk using incremental export	Sync	🔗 Github
`sections`	Sync Zendesk Help Center sections	Sync	🔗 Github
`ticket-comments`	Sync comments for tickets in scope	Sync	🔗 Github
`ticket-fields`	Sync ticket field definitions from Zendesk	Sync	🔗 Github
`ticket-forms`	Sync ticket forms from Zendesk	Sync	🔗 Github
`tickets`	Sync tickets from Zendesk Support	Sync	🔗 Github
`users`	Sync users from Zendesk Support using incremental cursor-based exports	Sync	🔗 Github
`views`	Sync ticket views from Zendesk	Sync	🔗 Github

​🚀 Quickstart

​📚 Zendesk Integration Guides

​🧩 Pre-built syncs & actions for Zendesk

​Articles

​Groups

​Help Center

​Macros

​Organizations

​Ticket Fields

​Ticket Forms

​Tickets

​Users

​Views

​Others