Documentation Index
Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
Use this file to discover all available pages before exploring further.
🚀 Quickstart
🧑💻 OAuth app setup
🔗 Useful links
🚨 API gotchas
Create an integration
In Nango (free signup), go to Integrations -> Configure New Integration -> Zendesk Sell. Nango doesn’t provide a test OAuth app for Zendesk Sell yet. You’ll need to set up your own OAuth app by following these instructions. After that, make sure to add the OAuth client ID and secret in the integration settings in Nango. Authorize Zendesk Sell
Go to Connections -> Add Test Connection -> Authorize, then log in to Zendesk Sell. Later, you’ll let your users do the same directly from your app. Call the Zendesk Sell API
Let’s make your first request to the Zendesk Sell API (fetch a list of deals). Replace the placeholders below with your secret key, integration ID, and connection ID:curl "https://api.nango.dev/proxy/v2/deals?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: '/v2/deals',
providerConfigKey: '<INTEGRATION-ID>',
connectionId: '<CONNECTION-ID>',
params: {
per_page: 10
}
});
console.log(res.data.items);
Next step: Embed the auth flow in your app to let your users connect their Zendesk Sell accounts. Create a Zendesk Sell account
Create & configure a Zendesk Sell OAuth app
- Log in to your Zendesk Sell account
- Go to Settings > Customization > Integrations
- Click on Add Integration and select Custom Integration
- Fill in the application details:
- Name: Your application name
- Website URL: Your application URL
- Redirect URI:
https://api.nango.dev/oauth/callback
- Save the integration and note the Client ID and Client Secret. You will need these to configure the integration in Nango.
- Rate limits: Zendesk Sell has a rate limit of 600 requests per minute for most endpoints. Some endpoints have lower limits.
