Skip to main content

Zendesk

Connection

Setup

Make an OAuth client for Klef in Zendesk, signed in as an admin. Zendesk acts as whoever made the client, so it must be an admin.
1
In Admin Center, go to Apps and integrations, then APIs, then OAuth Clients, and choose Add OAuth client.
2
Set Client kind to Confidential, and allow the scopes users:read, users:write, groups:read, groups:write, organizations:read, and organizations:write.
3
Save the client, then copy its Identifier and Secret into Klef, with your subdomain, the name before .zendesk.com.
Zendesk no longer issues API tokens, so Klef connects only through an OAuth client. Klef manages agents and admins. It never lists end users, who are your customers. When a worker’s email belongs to an end user, Klef gives that user the role the policy names. Klef suspends a user it removes, which keeps their tickets. A user is deleted only when a policy sets Deleted. Custom roles need the Enterprise plan or higher.

Settings

zendesk.user

Fields

Default Account Matching Rules

When Klef adopts an account that already exists in Zendesk, it works out whose it is by trying these in order. A connection can override them.

Examples

Zendesk agents

A Zendesk agent for everyone in support, suspended with their tickets kept when they leave.