Connect Zendesk to Retell AI with OAuth so agents can identify callers, look up their tickets, file new ones, and add comments or private notes.
Connecting Zendesk takes your Zendesk URL and an OAuth sign-in. One connection gives you agent functions: your agents identify callers, work their tickets, and record call outcomes as comments or notes.This page covers connecting and what the signed-in account needs.
Connect Zendesk when your support runs on it and you want an agent handling the front of the queue. It’s the right choice when you want to:
Identify callers without asking for a ticket number. The agent searches Zendesk for the caller’s number, finds their profile, and pulls up their active tickets before the caller finishes explaining.
File tickets from calls automatically. When a caller reports a new issue, the agent creates the ticket with a subject and description summarized from the conversation.
Keep the ticket as the source of truth. The agent adds the call’s outcome to the ticket as a public comment the requester sees, or a private internal note for your team.
For example, a software company’s support line answers with a Retell agent that searches the caller’s number, reads back the status of their most recent ticket, and adds a private note summarizing the call — a human only picks up when the issue is new or escalated.
A Zendesk account with an agent or admin role. Retell acts as whoever signs in, and end-user accounts can’t read other people’s tickets or work the queue.
Your Zendesk URL, https://your-subdomain.zendesk.com.
Use a dedicated integration account rather than a person’s account, so tickets and comments are attributed to the integration and the connection doesn’t break when someone leaves.
In the Retell Dashboard, open Integrations, select the Available tab, find Zendesk, and click Connect (Add Account if a connection already exists).
2
Enter your Zendesk URL and sign in
Fill in the fields:
Field
Value
Connection name
Alias for this connection; prefilled with Zendesk - OAuth.
Zendesk tenant URL
Your Zendesk URL, for example https://acme.zendesk.com.
The Zendesk connection dialog: your Zendesk URL, then an OAuth sign-in.
Click Connect (Add Account if a connection already exists). A Zendesk window opens; sign in with the integration account and approve the request. Retell asks for Zendesk’s read and write scopes, and the token can do only what those scopes and the account’s role allow. Retell stores the resulting token, so nobody has to sign in again.
Zendesk's consent screen for the Retell AI app — click Allow to finish connecting.
Admins can review or revoke this authorization anytime in Zendesk under Admin Center > Apps and integrations > APIs > External OAuth clients.
3
Confirm the connection
Retell tests the connection by fetching the signed-in user’s own profile. On success the connection appears on the Connected tab, and Zendesk tools appear in your agents’ function menus — see Zendesk agent functions for what they can do.
Check the tenant URL: it must be your own Zendesk origin, https://your-subdomain.zendesk.com, with nothing after the domain. A host-mapped vanity domain or a URL with a path won’t work.
The connection errored after working for a while
Retell flags a connection as errored when Zendesk rejects the stored token, usually because the account was suspended or the authorization was revoked under Admin Center > Apps and integrations > APIs > External OAuth clients. A role downgrade doesn’t error the connection; it shrinks what the tools can do (see required role). Open the connection’s settings and click Reconnect to sign in again.
