CRM
Zendesk
Connect Zendesk tickets to Atlas so support escalations sit next to product and engineering work.
What this connector does
- Sync Zendesk tickets, users, and organizations into Atlas.
- Create Atlas tasks from tickets without copying private comments by default.
- Reflect ticket status and assignee changes on both sides after mapping approval.
- Listen for ticket events with signed webhooks.
Before you begin
- You are a Zendesk admin.
- OAuth clients are allowed for your account.
- You have a sandbox account for first validation.
Get your credentials
Open Zendesk Admin Center
Sign in with the admin account. Zendesk OAuth clients
Open APIs, OAuth Clients
Click Add OAuth client and name it Atlas Connector.
Set the Redirect URL
Set Redirect URL to https://YOUR-ATLAS-HOST/oauth/callback/zendesk.
Copy the Unique Identifier and Secret
Zendesk shows the secret once. Copy both into the Atlas Zendesk connector settings page along with your subdomain.
Run the first sync
Click Connect and approve the OAuth grant. The connector status should change to Connected.
Required scopes and permissions
readwritetickets:readusers:readSetup checklist
- Create the provider app in a sandbox or development workspace.
- Add the Atlas redirect URL to the provider app configuration.
- Copy the client id, client secret, or API key.
- Paste the credentials into the Atlas connector settings page.
- Click Connect and complete the provider sign-in screen.
- Run Test connection from the connector page to verify health.
Troubleshooting
invalid_redirect_uri
Redirect URL must match exactly. Update the OAuth client in Admin Center.
invalid_grant
Refresh token expired or revoked. Reconnect from Atlas.
Forbidden
The connecting user must be a Zendesk admin. Light agents do not have OAuth client access.
Webhooks
Atlas creates Zendesk webhooks per ticket trigger and validates the X-Zendesk-Webhook-Signature header on every event.
Events Atlas listens for
- Ticket created
- Ticket updated
- Ticket comment created
- Ticket solved
Provider docs: https://developer.zendesk.com/documentation/webhooks/
Disconnect and data deletion
- Click Disconnect on the Atlas Zendesk connector page.
- Open Admin Center, OAuth Clients and delete Atlas Connector.
- Atlas removes cached ticket metadata within 24 hours of disconnect.
Once you have the credentials above, paste them into the live connector page to finish connecting Zendesk.
Open the Zendesk connector page