Zendesk Talk
Prerequisites
- A Zendesk account with a plan that includes the Zendesk Talk add-on
- Your Zendesk subdomain. For example, if your Zendesk URL is
https://mycompany.zendesk.com, your subdomain ismycompany. - One of these authentication methods:
- OAuth 2.0 (recommended): A Zendesk OAuth client with a client ID, client secret and refresh token
- API Token: A Zendesk API token and its associated email address. Zendesk disables new API token creation on October 27, 2026.
Setup
Step 1: Set up Zendesk
Choose one of these authentication methods:
API Token
:::caution Zendesk is removing API tokens as an authentication method. Starting October 27, 2026, Zendesk accounts can’t create new API tokens. You can only use API Token authentication with an active token you already have. Zendesk also deactivates tokens unused for 30 days. On April 30, 2027, Zendesk permanently deactivates all remaining API tokens. Sources using those tokens then stop syncing. Use OAuth 2.0 for new sources. Switch existing API token sources to OAuth before April 30, 2027. :::
Generate an API token in your Zendesk Admin Center under Apps and integrations > APIs > Zendesk API. See Managing API token access to the Zendesk API in the Zendesk documentation for details. Create a token specifically for Airbyte access. After October 27, 2026, Zendesk won’t let you create new tokens. These steps only work before that date.
OAuth 2.0
Register an OAuth client in your Zendesk Admin Center under Apps and integrations > APIs > OAuth Clients. See Using OAuth authentication with your application in the Zendesk documentation for details. Zendesk uses rotating refresh tokens. Each refresh returns a new refresh token and invalidates the previous one.
Step 2: Set up the connector in Airbyte
For Airbyte Cloud:
- Log into your Airbyte Cloud account.
- In the left navigation bar, click Sources. In the top-right corner, click + New source.
- From the Source type dropdown, select Zendesk Talk.
- Enter your Subdomain.
- Choose your Authentication method and enter the required credentials. Use OAuth 2.0 unless you already have an active API token.
- Set a Start Date for incremental streams. The connector replicates data created or updated after this date.
- Click Set up source.
Supported sync modes
The Zendesk Talk source connector supports these sync modes:
- Full Refresh
- Incremental Sync
Supported streams
You can sync these streams:
- Account Overview
- Addresses
- Agents Activity
- Agents Overview
- Calls (Incremental)
- Call Legs (Incremental)
- Current Queue Activity
- Greeting Categories
- Greetings
- IVRs
- IVR Menus
- IVR Routes
- Phone Numbers
Performance
The connector respects the Zendesk Talk API rate limits. The Talk API applies these limits alongside the standard Zendesk Support API limits:
| Endpoint | Rate limit |
|---|---|
| All Talk API endpoints | 15,000 requests per 5 minutes |
| Current Queue Activity | 2,500 requests per 5 minutes |
| Incremental Exports (Calls, Call Legs) | 10 requests per minute |
The connector automatically handles rate limits. It respects 429 responses and the Retry-After header. You shouldn’t encounter rate limit issues during normal use. If you do, create an issue.
Data type map
| Integration Type | Airbyte Type |
|---|---|
string | string |
number | number |
array | array |
object | object |
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 2.0.36 | 2026-11-10 | 91795 | Update dependencies |
| 2.0.35 | 2026-11-03 | 90906 | Simplify rate-limit and retry error handling configuration with no change in behavior |
| 2.0.34 | 2026-11-03 | 90809 | Update dependencies |
| 2.0.33 | 2026-10-27 | 90071 | Update dependencies |
| 2.0.32 | 2026-10-20 | 89478 | Update dependencies |
| 2.0.31 | 2026-10-13 | 88855 | Update dependencies |
| 2.0.30 | 2026-10-06 | 88101 | Update dependencies |
| 2.0.29 | 2026-09-29 | 87435 | Update dependencies |
| 2.0.28 | 2026-09-22 | 86870 | Update dependencies |
| 2.0.27 | 2026-09-15 | 86299 | Update dependencies |
| 2.0.26 | 2026-09-08 | 85734 | Update dependencies |
| 2.0.25 | 2026-08-18 | 84810 | Update dependencies |
| 2.0.24 | 2026-08-11 | 83814 | Persist OAuth token expiry on initial authentication so the first sync no longer refreshes and rotates away the single-use refresh token |
| 2.0.23 | 2026-08-11 | 84187 | Update dependencies |
| 2.0.22 | 2026-07-28 | 83194 | Update to CDK 7.23.8 (fixes AirbyteCustomCodeNotPermittedError for bundled custom components) and remove the temporary Cloud version override |
| 2.0.21 | 2026-07-28 | 1082 | Roll Cloud back to 2.0.19 — 2.0.20 is built on SDM 7.23.7, which breaks bundled custom components |
| 2.0.20 | 2026-07-28 | 83181 | Update dependencies |
| 2.0.19 | 2026-07-21 | 82651 | Update dependencies |
| 2.0.18 | 2026-07-14 | 82090 | Update dependencies |
| 2.0.17 | 2026-07-10 | 81516 | Fix infinite pagination loop on call_legs and calls incremental streams |
| 2.0.16 | 2026-06-30 | 81319 | Update dependencies |
| 2.0.15 | 2026-06-23 | 80706 | Update dependencies |
| 2.0.14 | 2026-06-16 | 80118 | Update dependencies |
| 2.0.13 | 2026-06-09 | 79570 | Update dependencies |
| 2.0.12 | 2026-06-02 | 76832 | Update dependencies |
| 2.0.11 | 2026-04-30 | 77647 | Promoted release candidate to GA |
| 2.0.11-rc.5 | 2026-04-24 | 77007 | Add subscription_tier config field and re-enable HTTPAPIBudget as dynamic tier-based budget for tuning iteration 5 |
| 2.0.11-rc.4 | 2026-04-22 | 76872 | Decrease default_concurrency from 6 to 4 and comment out HTTPAPIBudget for tuning iteration 4 |
| 2.0.11-rc.3 | 2026-04-17 | 76449 | Decrease default_concurrency from 9 to 6 for tuning iteration 3 |
| 2.0.11-rc.2 | 2026-04-13 | 76266 | Decrease default_concurrency from 12 to 9 for tuning iteration 2 |
| 2.0.11-rc.1 | 2026-04-10 | 76203 | Add concurrency support with default_concurrency of 12 |
| 2.0.10 | 2026-04-07 | 76106 | Add token_expiry_date to complete_oauth_output_specification so it is hidden from the UI as an OAuth-managed field |
| 2.0.9 | 2026-03-31 | 75808 | Update dependencies |
| 2.0.8 | 2026-03-11 | 74395 | Migrate to scopes object array format |
| 2.0.7 | 2026-03-10 | 74446 | Update dependencies |
| 2.0.6 | 2026-02-24 | 73990 | Update dependencies |
| 2.0.5 | 2026-02-17 | 73506 | Update dependencies |
| 2.0.4 | 2026-02-10 | 72070 | Update dependencies |
| 2.0.3 | 2026-02-03 | 72782 | Upgrade CDK version to 7.8.1 |
| 2.0.2 | 2026-01-28 | 72424 | Update breaking change deadline from Jan 31 to Jan 30 |
| 2.0.1 | 2026-01-27 | 72383 | Fix OAuth race condition with concurrent token refresh |
| 2.0.0 | 2026-01-21 | 71857 | Add OAuth2.0 with refresh token support. Users who authenticate via OAuth must re-authenticate. |
| 1.2.29 | 2026-01-14 | 71686 | Update dependencies |
| 1.2.28 | 2025-12-18 | 70683 | Update dependencies |
| 1.2.27 | 2025-11-25 | 70102 | Update dependencies |
| 1.2.26 | 2025-11-18 | 69569 | Update dependencies |
| 1.2.25 | 2025-10-29 | 68944 | Update dependencies |
| 1.2.24 | 2025-10-22 | 68591 | Add suggestedStreams |
| 1.2.23 | 2025-10-21 | 68411 | Update dependencies |
| 1.2.22 | 2025-10-14 | 67991 | Update dependencies |
| 1.2.21 | 2025-10-07 | 67246 | Update dependencies |
| 1.2.20 | 2025-09-30 | 66855 | Update dependencies |
| 1.2.19 | 2025-09-24 | 66473 | Update dependencies |
| 1.2.18 | 2025-09-09 | 65721 | Update dependencies |
| 1.2.17 | 2025-08-24 | 65426 | Update dependencies |
| 1.2.16 | 2025-08-10 | 64871 | Update dependencies |
| 1.2.15 | 2025-08-02 | 64320 | Update dependencies |
| 1.2.14 | 2025-07-27 | 64081 | Update dependencies |
| 1.2.13 | 2025-07-19 | 63611 | Update dependencies |
| 1.2.12 | 2025-07-12 | 63180 | Update dependencies |
| 1.2.11 | 2025-07-05 | 62730 | Update dependencies |
| 1.2.10 | 2025-06-28 | 62224 | Update dependencies |
| 1.2.9 | 2025-06-21 | 61753 | Update dependencies |
| 1.2.8 | 2025-06-15 | 61223 | Update dependencies |
| 1.2.7 | 2025-05-24 | 60770 | Update dependencies |
| 1.2.6 | 2025-05-10 | 59917 | Update dependencies |
| 1.2.5 | 2025-05-04 | 58933 | Update dependencies |
| 1.2.4 | 2025-04-19 | 58541 | Update dependencies |
| 1.2.3 | 2025-04-13 | 58053 | Update dependencies |
| 1.2.2 | 2025-04-05 | 56838 | Update dependencies |
| 1.2.1 | 2025-03-22 | 48245 | Update dependencies |
| 1.2.0 | 2025-02-07 | 50956 | Restore Unit Test |
| 1.1.0-rc.1 | 2024-10-31 | 47313 | Migrate to Manifest-only |
| 1.0.21 | 2024-10-29 | 47082 | Update dependencies |
| 1.0.20 | 2024-10-12 | 46861 | Update dependencies |
| 1.0.19 | 2024-10-05 | 46394 | Update dependencies |
| 1.0.18 | 2024-09-28 | 46149 | Update dependencies |
| 1.0.17 | 2024-09-21 | 45783 | Update dependencies |
| 1.0.16 | 2024-09-14 | 45524 | Update dependencies |
| 1.0.15 | 2024-09-07 | 45301 | Update dependencies |
| 1.0.14 | 2024-08-31 | 45019 | Update dependencies |
| 1.0.13 | 2024-08-24 | 44624 | Update dependencies |
| 1.0.12 | 2024-08-17 | 44214 | Update dependencies |
| 1.0.11 | 2024-08-10 | 43558 | Update dependencies |
| 1.0.10 | 2024-08-03 | 43203 | Update dependencies |
| 1.0.9 | 2024-07-27 | 42669 | Update dependencies |
| 1.0.8 | 2024-07-20 | 42328 | Update dependencies |
| 1.0.7 | 2024-07-13 | 41727 | Update dependencies |
| 1.0.6 | 2024-07-10 | 41350 | Update dependencies |
| 1.0.5 | 2024-07-09 | 41119 | Update dependencies |
| 1.0.4 | 2024-07-06 | 40855 | Update dependencies |
| 1.0.3 | 2024-06-25 | 40278 | Update dependencies |
| 1.0.2 | 2024-06-22 | 40056 | Update dependencies |
| 1.0.1 | 2024-06-04 | 39036 | [autopull] Upgrade base image to v1.2.1 |
| 1.0.0 | 2024-05-06 | 35780 | Migrate implementation to low-code CDK |
| 0.2.1 | 2024-05-02 | 36625 | Schema descriptions and CDK 0.80.0 |
| 0.2.0 | 2024-03-25 | 36459 | Unpin CDK version, add record counts in state messages |
| 0.1.13 | 2024-03-04 | 35783 | Change order of authentication methods in spec |
| 0.1.12 | 2024-02-12 | 35156 | Manage dependencies with Poetry. |
| 0.1.11 | 2024-01-12 | 34204 | Prepare for airbyte-lib |
| 0.1.10 | 2023-12-04 | 33030 | Base image migration: remove Dockerfile and use python-connector-base image |
| 0.1.9 | 2023-08-03 | 29031 | Reverted advancedAuth spec changes |
| 0.1.8 | 2023-08-01 | 28910 | Updated advancedAuth broken references |
| 0.1.7 | 2023-02-10 | 22815 | Specified date formatting in specification |
| 0.1.6 | 2023-01-27 | 22028 | Set AvailabilityStrategy for streams explicitly to None |
| 0.1.5 | 2022-09-29 | 17362 | always use the latest CDK version |
| 0.1.4 | 2022-08-19 | 15764 | Support OAuth2.0 |
| 0.1.3 | 2021-11-11 | 7173 | Fix pagination and migrate to CDK |