Skip to main content

Zendesk Talk

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable Self-Managed EnterpriseAvailable PyAirbyte
Support Level
Airbyte
Connector Version
2.0.10 (last updated 21 days ago)
Definition ID
c8630570-086d-4a40-99ae-ea5b18673071

Prerequisites​

  • A Zendesk account on a plan that includes the Zendesk Talk add-on
  • Your Zendesk subdomain (for example, if your Zendesk URL is https://mycompany.zendesk.com, the subdomain is mycompany)
  • One of the following authentication methods:
    • API Token: A Zendesk API token and the email address associated with the token
    • OAuth 2.0: A Zendesk OAuth client with a client ID, client secret, and refresh token

Setup guide​

Step 1: Set up Zendesk​

Choose one of the following authentication methods:

API Token

Generate an API token in your Zendesk Admin Center under Apps and integrations > APIs > Zendesk API. For details, see Generating a new API token in the Zendesk documentation. We recommend creating a token specifically for Airbyte access.

OAuth 2.0

Register an OAuth client in your Zendesk Admin Center under Apps and integrations > APIs > OAuth Clients. For details, see Using OAuth authentication with your application in the Zendesk documentation. Zendesk uses rotating refresh tokens, so each token refresh returns a new refresh token and invalidates the previous one.

Step 2: Set up the Zendesk Talk connector in Airbyte​

For Airbyte Cloud:

  1. Log into your Airbyte Cloud account.
  2. In the left navigation bar, click Sources. In the top-right corner, click + New source.
  3. Select Zendesk Talk from the Source type dropdown.
  4. Enter your Subdomain.
  5. Choose your Authentication method (API Token or OAuth 2.0) and enter the required credentials.
  6. Set a Start Date for incremental streams. Data created or updated after this date is replicated.
  7. Click Set up source.

Supported sync modes​

The Zendesk Talk source connector supports the following sync modes:

  • Full Refresh
  • Incremental Sync

Supported streams​

This connector syncs the following streams:

Performance considerations​

The connector respects the Zendesk Talk API rate limits. The Talk API enforces the following limits in addition to the standard Zendesk Support API limits:

EndpointRate limit
All Talk API endpoints15,000 requests per 5 minutes
Current Queue Activity2,500 requests per 5 minutes
Incremental Exports (Calls, Call Legs)10 requests per minute

The connector automatically handles rate limiting by respecting 429 responses and the Retry-After header. Under normal usage, you should not encounter rate limit issues. If you do, create an issue.

Data type map​

Integration TypeAirbyte Type
stringstring
numbernumber
arrayarray
objectobject

Reference​

Config fields reference

Field
Type
Property name
string
start_date
string
subdomain
object
credentials

Changelog​

Expand to review
VersionDatePull RequestSubject
2.0.11-rc.12026-04-1076203Add concurrency support with default_concurrency of 12
2.0.102026-04-0776106Add token_expiry_date to complete_oauth_output_specification so it is hidden from the UI as an OAuth-managed field
VersionDatePull RequestSubject
:--------:-----------:---------------------------------------------------------:----------------------------------------------------------------------------
2.0.11-rc.52026-04-24Add subscription_tier config field and re-enable HTTPAPIBudget as dynamic tier-based budget for tuning iteration 5
2.0.11-rc.42026-04-2176872Decrease default_concurrency from 6 to 4 and comment out HTTPAPIBudget for tuning iteration 4
2.0.11-rc.32026-04-1776449Decrease default_concurrency from 9 to 6 for tuning iteration 3
2.0.11-rc.22026-04-1376266Decrease default_concurrency from 12 to 9 for tuning iteration 2
2.0.11-rc.12026-04-0976203Add concurrency support with default_concurrency of 12
2.0.102026-04-06Add token_expiry_date to complete_oauth_output_specification so it is hidden from the UI as an OAuth-managed field
2.0.92026-03-3175808Update dependencies
2.0.82026-03-1174395Migrate to scopes object array format
2.0.72026-03-1074446Update dependencies
2.0.62026-02-2473990Update dependencies
2.0.52026-02-1773506Update dependencies
2.0.42026-02-1072070Update dependencies
2.0.32026-02-0372782Upgrade CDK version to 7.8.1
2.0.22026-01-2872424Update breaking change deadline from Jan 31 to Jan 30
2.0.12026-01-2772383Fix OAuth race condition with concurrent token refresh
2.0.02026-01-2171857Add OAuth2.0 with refresh token support. Users who authenticate via OAuth must re-authenticate.
1.2.292026-01-1471686Update dependencies
1.2.282025-12-1870683Update dependencies
1.2.272025-11-2570102Update dependencies
1.2.262025-11-1869569Update dependencies
1.2.252025-10-2968944Update dependencies
1.2.242025-10-2268591Add suggestedStreams
1.2.232025-10-2168411Update dependencies
1.2.222025-10-1467991Update dependencies
1.2.212025-10-0767246Update dependencies
1.2.202025-09-3066855Update dependencies
1.2.192025-09-2466473Update dependencies
1.2.182025-09-0965721Update dependencies
1.2.172025-08-2465426Update dependencies
1.2.162025-08-1064871Update dependencies
1.2.152025-08-0264320Update dependencies
1.2.142025-07-2764081Update dependencies
1.2.132025-07-1963611Update dependencies
1.2.122025-07-1263180Update dependencies
1.2.112025-07-0562730Update dependencies
1.2.102025-06-2862224Update dependencies
1.2.92025-06-2161753Update dependencies
1.2.82025-06-1561223Update dependencies
1.2.72025-05-2460770Update dependencies
1.2.62025-05-1059917Update dependencies
1.2.52025-05-0458933Update dependencies
1.2.42025-04-1958541Update dependencies
1.2.32025-04-1358053Update dependencies
1.2.22025-04-0556838Update dependencies
1.2.12025-03-2248245Update dependencies
1.2.02025-02-0750956Restore Unit Test
1.1.0-rc.12024-10-3147313Migrate to Manifest-only
1.0.212024-10-2947082Update dependencies
1.0.202024-10-1246861Update dependencies
1.0.192024-10-0546394Update dependencies
1.0.182024-09-2846149Update dependencies
1.0.172024-09-2145783Update dependencies
1.0.162024-09-1445524Update dependencies
1.0.152024-09-0745301Update dependencies
1.0.142024-08-3145019Update dependencies
1.0.132024-08-2444624Update dependencies
1.0.122024-08-1744214Update dependencies
1.0.112024-08-1043558Update dependencies
1.0.102024-08-0343203Update dependencies
1.0.92024-07-2742669Update dependencies
1.0.82024-07-2042328Update dependencies
1.0.72024-07-1341727Update dependencies
1.0.62024-07-1041350Update dependencies
1.0.52024-07-0941119Update dependencies
1.0.42024-07-0640855Update dependencies
1.0.32024-06-2540278Update dependencies
1.0.22024-06-2240056Update dependencies
1.0.12024-06-0439036[autopull] Upgrade base image to v1.2.1
1.0.02024-05-0635780Migrate implementation to low-code CDK
0.2.12024-05-0236625Schema descriptions and CDK 0.80.0
0.2.02024-03-2536459Unpin CDK version, add record counts in state messages
0.1.132024-03-0435783Change order of authentication methods in spec
0.1.122024-02-1235156Manage dependencies with Poetry.
0.1.112024-01-1234204Prepare for airbyte-lib
0.1.102023-12-0433030Base image migration: remove Dockerfile and use python-connector-base image
0.1.92023-08-0329031Reverted advancedAuth spec changes
0.1.82023-08-0128910Updated advancedAuth broken references
0.1.72023-02-1022815Specified date formatting in specification
0.1.62023-01-2722028Set AvailabilityStrategy for streams explicitly to None
0.1.52022-09-2917362always use the latest CDK version
0.1.42022-08-1915764Support OAuth2.0
0.1.32021-11-117173Fix pagination and migrate to CDK
Was this page helpful?