Skip to content
View as MarkdownOpen in ClaudeOpen in ChatGPT

Authorize Zendesk

Connect Zendesk to Whalesync by entering your account's subdomain and signing in, and what to do about each Zendesk connection error.

Whalesync connects to Zendesk by signing in to your Zendesk account, with read and write access. It acts as the user who signs in, so Zendesk records the changes it makes as that user's, and they run your account's triggers like any other change. Signing in as an admin of the account avoids permission errors.

Sign in

Section titled “Sign in”
  1. In Whalesync, choose Zendesk.
  2. In Zendesk subdomain, enter the first part of your Zendesk address: for acme.zendesk.com, enter acme. Enter the subdomain only, without https:// or .zendesk.com. The field refuses a pasted URL.
  3. Click Authorize. Zendesk's sign-in opens in the same tab rather than a popup. Sign in if it asks, and allow Whalesync access.
  4. Back in Whalesync, pick the tables to sync.

A connection is tied to its account. To reconnect it, sign in to the same Zendesk account. If the account's subdomain changes, create a new connection.

Errors

Section titled “Errors”
Message What to do
Invalid characters The subdomain field holds a URL or other characters a subdomain can't have. Enter only the subdomain, such as acme.
Enter your Zendesk subdomain: the "yourcompany" part of yourcompany.zendesk.com The subdomain is missing or isn't a valid subdomain. Enter only the first part of your Zendesk address.
This connection syncs the Zendesk account … Sign in to that account to reconnect it You signed in to a different Zendesk account than the one the connection syncs. Sign in to the account the message names, or create a new connection for the other account.
Zendesk no longer accepts the credentials Whalesync is using Access was revoked, or the sign-in stopped working. Reconnect Zendesk.
Whalesync doesn't have permission to do this in Zendesk The signed-in user lacks a permission in Zendesk. Zendesk's own message replaces this one when it gives one. Reconnect Zendesk as an admin of the account.
Your Zendesk plan does not include the feature Whalesync tried to use The account's Zendesk plan doesn't include a feature the sync uses.
Zendesk is rate limiting Whalesync Nothing. Zendesk's per-minute limit is shared with your account's other apps, and Whalesync retries when it resets.