Playlist has a collection of endpoints that enables you to integrate with Zendesk and other tools.
You can authorize against the API using your API key.
To generate your API key, go to Playlist Setup > Tools > API Key and click on "Generate API Key."
When making requests, simply add your key to the X-API-Key header.
The Playlist API is rate limited. To ensure a high quality of service for all clients, only a certain number of requests are allowed. These rate limits are subject to change, but you can expect the following limits:
- 50 requests per second
- 10,000 requests per day
If the rate limit is exceeded, the API responds with a HTTP 429 Too Many Requests error.
The API is narrow in scope and has very little interaction with your Zendesk. Here's a full list of tools that utilize your API key for authentication:
- Webhook: assign to a dedicated support agent
- Webhook: assign to the same agent within a short window of time
- Agent Status API (beta)
All webhooks are restricted to Zendesk's IP addresses, so they can only be called directly from the Zendesk platform (e.g. Zendesk triggers).
Still, we recommend rotating your key (deactivate and generate a new one) every 6 months for security purposes.