Zendesk (Helpdesk)

Integrate your application with the Zendesk API

🚀 Quickstart

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

1. Create an integration

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

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

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

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

   Node

   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.

4. Implement Nango in your app

   Follow our quickstart 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.

Categories

Function name	Description	Type	Source code
create-category	Create a category within the help center	Action	🔗 Github
categories	Fetches a list of help center categories	Sync	🔗 Github

Sections

Function name	Description	Type	Source code
create-section	Create a section within a category in the help center	Action	🔗 Github
sections	Fetches a list of sections in Help center from Zendesk	Sync	🔗 Github

Tickets

Function name	Description	Type	Source code
create-ticket	Create a Zendesk ticket	Action	🔗 Github
tickets	Fetches a list of tickets from Zendesk	Sync	🔗 Github

Users

Function name	Description	Type	Source code
create-user	Create an admin or agent user in Zendesk. Defaults to agent if a role is not provided	Action	🔗 Github
delete-user	Delete a user in Zendesk	Action	🔗 Github

Others

Function name	Description	Type	Source code
fetch-article	Fetch a single full help center article	Action	🔗 Github
fetch-articles	Fetch all help center articles metadata	Action	🔗 Github
search-tickets	An action that performs a search for tickets in Zendesk based on the specified filter. It can take up to a few minutes for new tickets and users to be indexed for search. If new resources don’t appear in your search results, wait a few minutes and try again.	Action	🔗 Github
articles	Fetches a list of articles in Help center from Zendesk	Sync	🔗 Github
users	Fetches a list of admin or agent users from Zendesk	Sync	🔗 Github

---