Common Issues

Connection issues

Authentication fails when I enter my API token

Zendesk Talk uses a combined credential format. Make sure you're entering your email address (not just your username) and the API token (not your account password). In Zendesk, API tokens are found under Admin Center → Apps and integrations → Zendesk API → API tokens. Also confirm that API access is enabled on that same page — it can be toggled off.

My subdomain isn't being accepted

Enter only the subdomain portion — for example, if your Zendesk URL is acme.zendesk.com, enter acme. Do not include https://, .zendesk.com, or any trailing slashes.

Missing data

Calls or Call legs return no data

Both entities require a start date. If no start date is set, the export may return empty results. Use the date picker to set a start date that covers the period you need. Also confirm that calls were actually made in that period — if the account was newly set up, there may be no records yet.

Current queue activities or Agents overviews show unexpected zeros

These entities reflect the real-time state at the moment the data flow runs. If you run the data flow outside business hours or when no agents are online, values like calls_waiting or agents_on_call will legitimately be zero. Schedule runs during active hours if you need meaningful snapshots.

IVR menus or IVR routes return no rows

These entities only return data if IVRs are configured in your Zendesk Talk account. If your account uses simple line routing without IVRs, these entities will be empty.

Permission errors

I get a 403 Forbidden error

The agent account whose credentials you're using may not have sufficient permissions. Zendesk Talk API access typically requires an Administrator role. Ask your Zendesk admin to either grant admin rights to your account or generate a dedicated API token using an admin account.

Call recordings are missing from the Calls entity

The recording_url field only appears if call recording is enabled for your Zendesk Talk plan and the specific line. Additionally, access to recordings may be restricted by role — agents may see their own recordings, but not others'. Confirm recording settings under Admin Center → Channels → Talk.

Data discrepancies

Call counts in Coupler.io don't match the Zendesk Talk dashboard

Zendesk Talk dashboards often apply their own date/time filters and may use the account's local timezone. Coupler.io exports timestamps in UTC. Check that you're comparing the same time window accounting for timezone differences. Also note that Zendesk Talk may count abandoned calls differently depending on the dashboard view.

Rate limits

The data flow fails with a rate limit error

Zendesk's API enforces rate limits that vary by plan (typically 700 requests per minute for most plans). Exporting very large date ranges for Calls or Call legs in a single run can trigger these limits. Narrow your start date to a shorter window and run multiple data flows for different periods if needed.