Skip to main content

Reconnect Zendesk Support

Use these steps to reauthorize Assembled's connection to Zendesk Support. You might need to do this after a security incident, when the Zendesk admin who connected Assembled leaves, or when syncs fail with an authorization error.

If you're here because of the November 13, 2026 security incident: Zendesk Support syncs stop until you reconnect, and reconnecting is safe. Reconnect Zendesk Support first, then any other Zendesk integrations you use. For more about the incident, see November 13, 2026 security incident.

Who does this

  • An Assembled admin, or someone with a role that can configure third-party integrations.
  • An active Zendesk admin. If you use AI agents or Copilot with Zendesk, this account needs read and write access. We recommend using a shared service account rather than a personal one.

Before you start

  • Have your Zendesk subdomain ready. That's the example in example.zendesk.com.
  • Check whether Zendesk unified agent status is turned on for your account, so you can make the same choice when you reconnect.

Steps

  1. If Assembled's old authorization still shows as active in your Zendesk account, have your Zendesk admin revoke it and confirm it's inactive before you reconnect.
  2. In Assembled, go to Configure > Third-party integrations and select Available. On the Zendesk card, select Configure integration and enter your Zendesk subdomain. Enter only the subdomain, for example example, not example.zendesk.com.
  3. Select Sign in, sign in to Zendesk as an active admin, and approve access when Zendesk asks.
  4. Back in Assembled, choose Turn it on or Maybe later for Zendesk unified agent status, matching what you had before. Then select Next and Done.
  5. On the Zendesk card in Configure > Third-party integrations, check that the sync rows show a new successful sync.

    A connected Zendesk card on Configure > Third-party integrations with the Connected tag, its sync rows, the domain and authorized scope, and Edit settings

How to confirm it's working

  • On the Zendesk card, check for a recent successful sync. The Connected tag on its own doesn't confirm that data is flowing.
  • If a sync row is red, hover over it to see the error, and send that error text to Support.
  • If you use AI agents or Copilot, test a handoff to Zendesk to confirm it still works.

When you'll see data

Assembled checks Zendesk for ticket updates about every 15 seconds and for agent states about every 30 seconds. Ticket events sync every 5 minutes and survey responses every 2 hours. After you reconnect, allow time for the next scheduled sync. Reports can take a little longer to refresh.

Restoring missed data

Reconnecting normally starts a backfill of your Zendesk history automatically. While it runs, the Zendesk card shows Backfill in progress, and when it's done it shows the date it's backfilled until. If you need a different date range, or you still see gaps from while Zendesk was disconnected, contact Support and let us know which dates are affected.

Things to watch for

  • Reconnect Zendesk Support first. Then reconnect Zendesk Talk or Sunshine/Conversations if you use them.
  • Sign in as an active Zendesk admin. If syncs fail with a 401 or 403 error after you reconnect, reconnect again with an active admin account.
  • Keep your existing settings. Choose the same unified agent status option as before, and don't change your status mappings just to reconnect.
  • Don't select Remove on a Zendesk Sunshine/Conversations card. Removing it deletes its saved settings.
  • Replace any other Zendesk tokens. If you saved a Zendesk API token in Assembled for AI agent tools and connectors, create a new token in Zendesk, update it in Assembled, then delete the old token in Zendesk.

For more about how the integration works, see Zendesk Support integration.

Need help?

If something doesn't look right, contact our Support team and include any error text you see on the Zendesk card. Please don't send API tokens or passwords by email or chat.

Still have questions?