Docs / Connecting Zendesk
Connecting Zendesk
Admin-enabled API tokens, and three Zendesk-specific limits worth knowing before you edit a ticket.
Set up
- In Zendesk: an admin enables API access at Admin Center → Apps and integrations → APIs → Zendesk API → Token access.
- Generate a token: Admin Center → Apps and integrations → APIs → API tokens → Add API token.
- In Z3NTRA: Systems → Connect a system → Zendesk.
- Subdomain — the part in
yourcompany.zendesk.com. - Email and API token from steps 1–2.
- Subdomain — the part in
What gets pulled in
Tickets currently assigned to you.
What write-back changes — and three things it can't
Description isn't editable
A Zendesk ticket's description is its first comment, which the API treats as read-only. Editing the description in Z3NTRA adds it as a private note on the ticket instead of overwriting anything.
Due dates only exist on ticket type "Task"
Regular tickets (incidents, problems, questions) have no due-date field. Editing the deadline on one of those saves in Z3NTRA only, and the UI says so.
Closed tickets are terminal
Zendesk won't let the API reopen a closed ticket, so a status change on one also saves in Z3NTRA only rather than failing silently.