Skip to content

Connect Zendesk

Add an OAuth client in Zendesk Admin Center with Client kind set to Confidential. Then open the Zendesk card under Integrations and choose Zendesk sign-in (OAuth). Enter your subdomain, group ID, client identifier and secret, then select Connect with Zendesk.

Use this guide to connect Zendesk under Integrations so custom workflows can open Zendesk tickets. Connecting Zendesk is a one-time setup. Custom workflows with a Zendesk block then use the connection.

Add an OAuth client in Zendesk

  1. In Zendesk Admin Center, go to Apps and integrations > APIs > OAuth clients. The first time anyone opens this page, Zendesk asks you to accept its Developer Terms and select Get started.
  2. Select Add OAuth client.
  3. Enter a Name, Description and Company your team will recognize, such as Webscale AI. Zendesk shows them on the screen where you allow access.
  4. Keep the suggested Identifier or type your own. You enter it in the Webscale AI console.
  5. Set Client kind to Confidential. The default, Public, doesn't work with Webscale AI.
  6. Under Redirect URLs, add the URL the Webscale AI console's connection page shows. Leave Allowed scopes empty.
  7. Select Save. Copy the Secret right away. Zendesk shows it in full only once.
  1. In Zendesk Admin Center, go to Apps and integrations > APIs > OAuth clients and select Add OAuth client. The first time anyone opens this page, Zendesk asks you to accept its Developer Terms and select Get started.
  2. Fill in the client as shown in the table below, then select Save.
  3. Copy the Secret right away. Zendesk shows it in full only once. If you lose it, open the client again and generate a new one.
Zendesk field What to enter
Name, Description and Company Something your team will recognize, such as Webscale AI. Zendesk shows these on the screen where you allow access
Identifier Keep the suggested value or type your own. You enter it in the console
Client kind Confidential. The default, Public, doesn’t work with Webscale AI
Redirect URLs https://dashboard.ai.webscale.com/api/external/connectors/zendesk/oauth/callback, the URL the console’s connection page shows
Allowed scopes Leave it empty

Connect Zendesk

  1. Open the account menu and select Integrations. On the Zendesk card, select Connect. Under Connect with, Zendesk sign-in (OAuth) is selected.
  2. Enter your Zendesk Subdomain and the numeric Group ID of the Zendesk group that should receive tickets.
  3. Enter the client's Identifier as the Client unique identifier, then paste the Client secret.
  4. Select Connect with Zendesk. Sign in to Zendesk if asked and allow access. You return to Integrations, which shows Zendesk connected.
  1. Open the account menu and select Integrations. On the Zendesk card, select Connect. Under Connect with, Zendesk sign-in (OAuth) is selected.
  2. Enter your Zendesk Subdomain and the numeric Group ID of the Zendesk group that should receive tickets.
  3. Enter the client’s Identifier as the Client unique identifier, then paste the Client secret.
  4. Select Connect with Zendesk. Sign in to Zendesk if asked and allow access.

You return to Integrations, which shows Zendesk connected. The Zendesk card shows Connected. Select Update connection on the card. The page says the connection uses the Zendesk sign-in. Zendesk sign-in (OAuth) reads “Connected. Tickets use this sign-in.”

To check tickets end to end, build a custom workflow with a Zendesk block and test it in the agent’s Playground, as described in Test changes in the Playground.

The Zendesk sign-in gives Webscale AI read and write access to your Zendesk Support data. Webscale AI acts as the Zendesk user who signed in, so it can do only what that user’s role allows. Webscale AI uses the access to open tickets from your custom workflows and to check that the connection works. Sign in as a Zendesk admin or as an agent who can create tickets in the group you chose.

Zendesk sign-ins expire after a set time. Webscale AI renews the sign-in before that happens, so nobody needs to sign in again unless someone removes the sign-in in Zendesk.

A Zendesk connection made with an API token keeps working until 30 April 2027. Zendesk stopped issuing new API tokens on 27 October 2026 and turns off every API token on 30 April 2027, as its API token announcement explains. The connection page shows a reminder at the top while a connection still uses a token.

  1. On the Zendesk card, select Update connection.
  2. Under Connect with, select Zendesk sign-in (OAuth). Check that Subdomain and Group ID are right.
  3. Add an OAuth client in Zendesk as described in Add an OAuth client in Zendesk. Enter its Client unique identifier and Client secret.
  4. Select Connect with Zendesk. Sign in to Zendesk if asked and allow access.

The switch updates the same Zendesk connection, so custom workflows that use it keep working.

Change or disconnect the Zendesk connection

Section titled “Change or disconnect the Zendesk connection”

On a Zendesk connection made with the sign-in, only Group ID can change. Select Update connection on the Zendesk card, enter the new group ID and select Update. To use another Zendesk account, subdomain or OAuth client, disconnect and connect again.

To disconnect, select Update connection on the Zendesk card, then select Disconnect. Type disconnect to confirm. Webscale AI deletes the saved sign-in and asks Zendesk to cancel it. Custom workflows with a Zendesk block can’t open tickets until you connect again.

Problem Fix
Integrations shows “Zendesk wasn’t connected: the sign-in was cancelled.” Start again from the Zendesk card and allow access when Zendesk asks
Integrations shows “The Zendesk sign-in expired. Please try again.” Start again from the Zendesk card. The sign-in has to finish soon after you select Connect with Zendesk
Integrations shows “Zendesk sign-in worked, but the account couldn’t be read.” Sign in as a Zendesk user with agent or admin access, then connect again
The Zendesk card no longer shows Connected after it worked before The sign-in expired or was removed in Zendesk. Select Update connection on the Zendesk card, select Disconnect, then connect again
Integrations shows “Couldn’t connect Zendesk. Please try again.” Check that the OAuth client’s Client kind is Confidential and that its Redirect URLs match the URL on the connection page. Check the Client unique identifier and Client secret, then connect again
You lost the client secret Open the OAuth client in Zendesk Admin Center and generate a new secret. Then disconnect and connect again with the new secret

Frequently asked questions

What can Webscale AI do with the Zendesk sign-in?
It gets read and write access to your Zendesk Support data and acts as the Zendesk user who signed in, within that user's role. Webscale AI uses it to open tickets from your custom workflows.
Do I have to switch from an API token to the Zendesk sign-in?
Yes, before 30 April 2027. Zendesk turns off every API token that day and stopped issuing new ones on 27 October 2026. Switching updates the same connection, so your custom workflows keep working.
Do I need to sign in to Zendesk again from time to time?
No. Zendesk sign-ins expire after a set time. Webscale AI renews the sign-in before that happens. You only connect again if someone removes the sign-in in Zendesk.
Does this connect live chat too?
No. Live chat uses the separate Zendesk Live card. Set up escalation to a person covers it.