Connect Zendesk to Rig

Before you start

• You need to be a Zendesk administrator.
• Have three things to hand: your subdomain (the acme in acme.zendesk.com), an agent email, and the API token you'll create below.

Step 1: Turn on API token access

1. In Zendesk, open Admin Center.
2. In the sidebar, go to Apps and integrations → APIs → API configuration.
3. Tick Allow API token access and click Save. Token access is off by default, so this step is required before you can create a token.

Step 2: Create an API token

1. Still under Apps and integrations → APIs, open API tokens and click Add API token.
2. Optionally add a description such as "Rig" so you can recognise it later.
3. Copy the token now. Once you close the window the full token is never shown again. Then click Save.

Step 3: Connect it in Rig

1. In Rig, open Connections in the left sidebar and go to the Sources step.
2. Search for Zendesk and click its card.
3. Zendesk subdomain: enter just the subdomain, e.g. acme for acme.zendesk.com.
4. Agent email: the email of the account the token belongs to.
5. API token: paste the token you copied.
6. Click Continue, then Test to pull a small sample, then Sync to run the full pipeline.

Behind the scenes Rig authenticates using HTTP basic auth with the username email/token and the token as the password. You don't need to format anything; Rig assembles it for you.

What Rig pulls in

Zendesk Support lands in its own zendesk schema:

• Tickets and ticket metrics
• Users
• Organizations
• Groups

Good to know

• If a token leaks, delete it in Admin Center → Apps and integrations → APIs → API tokens and create a new one.
• For tighter access, consider creating a dedicated admin account for the integration rather than using a personal login.
• You can disconnect Zendesk at any time from Connections → Sources.