Zendesk — Application Overview
Overview
Zendesk is a customer support and ticketing platform used by support, success, and operations teams to manage customer conversations, ticket workflows, and service requests.
The Zendesk integration within the Wrk platform lets you automate ticket retrieval, updates, comments, and related API workflows through prebuilt Wrk Actions.
This document provides an overview of how Zendesk integrates into Wrk, how authentication works, general API behaviour, and a list of available Wrk Actions.
Authentication
Zendesk uses API token (basic) authentication in Wrk.
The Connected Account requires:
| Input | Description |
|---|---|
| Zendesk email | The email address associated with the Zendesk user |
| Zendesk subdomain | The subdomain of your Zendesk instance (for example yourcompany in yourcompany.zendesk.com) |
| Zendesk API token | An API token from Admin Center → Apps and integrations → APIs → Zendesk API |
Important Notes
- API tokens are tied to a specific Zendesk user and inherit that user’s permissions.
- If the token is rotated or revoked, update the Connected Account in Wrk.
- Requests are made against your Zendesk subdomain instance.
General API Behaviour
Tickets and comments
Most Wrk Actions work with Zendesk Support tickets. Ticket operations typically require a ticket ID, and comment actions append public or private comments to an existing ticket.
Search and retrieve actions return JSON payloads from the Zendesk API that can be used by later steps in a Wrkflow.
Pagination and search
List and search endpoints may return paginated results. When working with large ticket volumes, prefer search or filtered retrieval and iterate through pages rather than assuming a single response contains every record.
Available Wrk Actions
- Create comment on a ticket
- Perform an API call
- Retrieve ticket details
- Search for tickets
- Update custom ticket details
- Update standard ticket details
- Update ticket status
Additional Resources
- Zendesk API reference: https://developer.zendesk.com/api-reference/
- API token authentication: https://developer.zendesk.com/api-reference/introduction/security-and-auth/#api-token
- Tickets API: https://developer.zendesk.com/api-reference/ticketing/tickets/tickets/
- Search API: https://developer.zendesk.com/api-reference/ticketing/ticket-management/search/