This is the reference documentation for the Zendesk Integration Services (ZIS) APIs. It documents the REST APIs you can use to build and run an integration using ZIS. The ZIS APIs power Conversational Data Orchestration.
ZIS APIs are available on Suite Growth and above and Support Professional and above. If you're interested in becoming a Zendesk developer partner, you can convert a trial account into a sponsored Zendesk account. See Getting a trial or sponsored account for development.
For information on the syntax and style conventions used, see Documentation conventions in the general API introduction.
For information on the curl examples used in the APIs, see Examples in the general API introduction.
Security and authentication
ZIS APIs use OAuth 2.0 for authenticating requests, unless stated otherwise. The OAuth access token must be associated with the ZIS integration specified in the request. To get this token, see Obtaining a ZIS OAuth token.
Some endpoints support other authentication methods, including:
- Basic authentication
- API token
- Browser session authentication in a Zendesk app
If supported, these authentication methods are noted in the endpoint's documentation. For more information about basic authentication and API tokens, see Security and authentication in the general API introduction. For more information about browser session authentication, see Making API requests from a Zendesk app.
The following API rate limits apply:
- 2,000 requests/minute to the ZIS Inbound Webhooks API
- 6,000 requests/minute to the ZIS Links API
If a rate limit is exceeded, the API responds with an HTTP 429 Too Many Requests status code.
For more information on the number of requests allowed per minute, see Rate limits in the general API introduction.
For information on the JSON request format, see Request format in the general API introduction.
For information on the HTTP status codes returned by these APIs, see Response format in the general API introduction.
For information on paginating through list endpoints, see Pagination in the general API introduction.
For information on data types returned by the APIs, see Data types in the general API introduction.