Connect Zendesk
What connecting Zendesk does, from caller names to calls logged back, and how to get its details and connect it.
Zendesk is a help desk. This article explains what connecting it does and how to connect it.
What it does
Your Zendesk contacts are copied into your company contacts, so a caller Zendesk knows shows by name on every desk phone and app before anyone picks up, and in your call history afterwards.
With call logging on, every finished call is filed in Zendesk on the matching record: who took it, how long it lasted, missed calls and voicemails, and the call summary. You can log texts too (one note per conversation once it goes quiet for half an hour), and add a link to the call in the portal. When Zendesk doesn't know the caller, you choose to skip the call, or create a new user.
Contacts sync every 6 hours (Zendesk can only send everything at once), with a full sync each day that also removes contacts deleted there. Sync now on Contacts brings changes in straight away.
Before you start
- Plan: Suite Team, Growth, Professional, Enterprise or Enterprise Plus, or Support Team, Professional or Enterprise.
- Who: A Zendesk admin.
- On our side: a company administrator connects it, once, for the whole company.
Get your details from Zendesk
- In Admin Center, go to Apps and integrations > APIs > API configuration, tick Allow API token access and save. It is off by default.
- Go to APIs > API tokens, click Add API token, give it a description and save.
- Copy the token: it is shown once.
Connect it
- In the portal, go to Contacts and click Connect a CRM (or Connect another CRM). You can also start from Company > Integrations.
- Choose Zendesk and fill in:
- Click Connect & sync. The first sync runs straight away and says how many contacts came across.
- To file calls in Zendesk, tick Log finished calls into Zendesk on the connection, and choose what happens when Zendesk doesn't know the caller.
- Subdomain (company .zendesk.com): the part before .zendesk.com in your Zendesk address - Admin email: the email the admin signs in to Zendesk with - API token: the token from step 3
If it says Needs attention
The connection's card on Company > Integrations shows the last error. The usual causes:
- The key was reset, expired or deleted in Zendesk: make a new one and connect again with it.
- The person who made the key lost access or left: make the key as someone who is staying.
- Logged calls arrive as solved tickets with a private note, tagged cannon_call_log. Add "Tags contains none of cannon_call_log" to any trigger that emails requesters, or your callers get emails about their calls.
- Zendesk has announced it is retiring API tokens: from July 28, 2026 a token unused for 30 days is deleted, and every token stops working by April 30, 2027. Keeping this connection on uses the token every day, so it isn't deleted for being idle. Contact support before April 2027 about moving this connection to Zendesk's newer sign-in.
Press Sync now on the connection to try again straight away. To stop, press Disconnect: contacts already copied stay in your contacts, and calls already logged stay in Zendesk.
