Skip to main content

Update Zendesk QA (Klaus) credentials

To replace the API token Assembled uses to connect to Zendesk QA, you create a new one in Zendesk QA, and our Support team helps you update it in Assembled. How it's updated depends on how your connection was set up, so please contact Support before you change anything.

If you're here because of the November 13, 2026 security incident: Assembled can't revoke Zendesk QA credentials from our side, so please replace yours using these steps. Pausing or disconnecting the integration in Assembled doesn't stop the old API token from working. Only retiring it in Zendesk QA does. 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.
  • A Zendesk QA (formerly Klaus) admin who can create and revoke API tokens.

Before you start

  • Contact Support and tell us which Zendesk QA accounts you use with Assembled, including any test or sandbox accounts. Don't send credentials by email or chat.
  • Note any custom Zendesk QA settings you've set up in Assembled, such as mappings, so we can check them with you.

Steps

  1. Contact Support. We'll confirm which API token Assembled uses for your account and how to update it.
  2. In Zendesk QA, have your admin create a new API token.
  3. Follow Support's instructions to update the token in Assembled. Don't remove the integration or set it up again from scratch, because that can delete your saved settings.
  4. Once the new API token is working, have your Zendesk QA admin revoke the old API token.
  5. Check the Zendesk QA card in Configure > Third-party integrations for a new successful sync.

How to confirm it's working

  • On the Zendesk QA card, check for a recent successful sync. The Connected tag on its own doesn't confirm that data is flowing.
  • Check that new QA reviews appear in Assembled.
  • If a sync row is red, hover over it to see the error, and send that error text to Support.

When you'll see data

Assembled syncs Zendesk QA reviews every 5 minutes. After the connection is updated, allow time for the next scheduled sync. Reports can take a little longer to refresh.

Restoring missed data

Updating the connection normally starts a backfill of your Zendesk QA history. If you've customized Zendesk QA mappings or settings in Assembled, let Support check them first, because a backfill that runs with missing settings can overwrite history. If you still see gaps, contact Support with the dates affected.

Things to watch for

  • Contact Support first. We'll confirm the right way to update your connection before you change anything.
  • Don't remove the integration. Removing it or setting it up again from scratch can delete your saved settings.
  • Retire the old API token in Zendesk QA. Disconnecting or pausing the integration in Assembled doesn't stop it from working.
  • Keep the same access. Give the new API token the same permissions as the old one, or syncs can fail.

For more about how the integration works, see Zendesk QA (Klaus) integration.

Need help?

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

Still have questions?