Advanced Analytica Advanced Analytica: IBOM
← All connectors
Zendesk Chat logo

Source connector

Zendesk Chat

Set up Zendesk Chat as a source and move its data into your chosen destination.

Version 1.3.34 certified generally available

Zendesk Chat

Use this page to set up the Zendesk Chat source connector and find reference information.

Prerequisites

  • (Airbyte Open Source) An access token. See OAuth Authentication for details. Create a restricted, read-only token specifically for Airbyte access.

Setup

For Airbyte Cloud:

  1. Log into your Airbyte Cloud account.
  2. Click Sources, then click + New source.
  3. On the Set up the source page, select Zendesk Chat from the Source type dropdown.
  4. Enter a name for the Zendesk Chat connector.
  5. For Subdomain, enter your Zendesk subdomain. For example, if your Zendesk URL is https://mycompany.zendesk.com, enter mycompany.
  6. For Start Date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. Data added on or after this date will be replicated.
  7. Click Authenticate your Zendesk Chat account. Log in and authorise your Zendesk Chat account. The OAuth flow requests read and chat scopes.
  8. Click Set up source.

For Airbyte Open Source:

  1. Go to the Airbyte Open Source dashboard.
  2. Click Sources, then click + New source.
  3. On the Set up the source page, select Zendesk Chat from the Source type dropdown.
  4. Enter a name for the Zendesk Chat connector.
  5. For Subdomain, enter your Zendesk subdomain. For example, if your Zendesk URL is https://mycompany.zendesk.com, enter mycompany.
  6. For Start Date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. Data added on or after this date will be replicated.
  7. For Authorization Method, select Access Token from the dropdown. Enter your Zendesk access token. The token must have the read and chat scopes.
  8. Click Set up source.

Supported sync modes

The Zendesk Chat source connector supports these sync modes:

Supported streams

Performance

The Zendesk Chat API enforces a rate limit of 200 requests per minute per endpoint. The connector automatically manages rate limits by respecting the Retry-After header when it receives a 429 response.

Troubleshooting

Invalid, expired or incorrectly scoped access token

The connector stops the sync and reports a configuration error when Zendesk Chat returns a 401 Unauthorized response. To resolve this error:

  • Airbyte Cloud: Edit the source and click Authenticate your Zendesk Chat account to re-authorise the connection.
  • Airbyte Open Source: Generate a new access token with the read and chat scopes. Then update the Access Token field.

Requests returning 404

The connector ignores any 404 Not Found response from Zendesk Chat and continues the sync. It doesn’t emit records from that request. This response usually occurs when a record has been deleted. However, this behaviour applies to every stream and request. A 404 response on a list request therefore drops that results page.

Data type map

Integration TypeAirbyte Type
stringstring
numbernumber
arrayarray
objectobject

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
VersionDatePull RequestSubject
1.3.342026-11-1091778Update dependencies
1.3.332026-11-0390807Update dependencies
1.3.322026-10-2790082Update dependencies
1.3.312026-10-2089485Update dependencies
1.3.302026-10-1388886Update dependencies
1.3.292026-10-0688112Update dependencies
1.3.282026-09-2987433Update dependencies
1.3.272026-09-2286888Update dependencies
1.3.262026-09-1683336Show a clearer error when Zendesk Chat rejects the access token
1.3.252026-09-1586312Update dependencies
1.3.242026-09-0885714Update dependencies
1.3.232026-08-1884835Update dependencies
1.3.222026-08-1184170Update dependencies
1.3.212026-07-2883194Update to CDK 7.23.8 (fixes AirbyteCustomCodeNotPermittedError for bundled custom components) and remove the temporary Cloud version override
1.3.202026-07-281082Roll Cloud back to 1.3.18 — 1.3.19 is built on SDM 7.23.7, which breaks bundled custom components
1.3.192026-07-2883161Update dependencies
1.3.182026-07-2182671Update dependencies
1.3.172026-07-1482082Update dependencies
1.3.162026-06-3081327Update dependencies
1.3.152026-06-2380709Update dependencies
1.3.142026-06-1680102Update dependencies
1.3.132026-06-0979569Update dependencies
1.3.122026-06-0279069Update dependencies
1.3.112026-04-2877490Update dependencies
1.3.102026-04-2176846Bump SDM base image to stable 7.17.2
1.3.92026-03-3175942Bump SDM base image for memory monitor (CDK PR #962)
1.3.82026-03-3175858Update dependencies
1.3.72026-03-1774324Migrate to scopes object array format
1.3.62026-03-1775116Update dependencies
1.3.52026-03-1074671Update dependencies
1.3.42026-03-0374156Update dependencies
1.3.32026-02-1773534Update dependencies
1.3.22026-02-1073151Update dependencies
1.3.12026-02-0372611Update dependencies
1.3.02026-01-2871829Add OAuth2.0 support for Airbyte Cloud
1.2.312026-01-2072091Update dependencies
1.2.302026-01-1471701Update dependencies
1.2.292025-12-1870681Update dependencies
1.2.282025-11-2570128Update dependencies
1.2.272025-11-1869513Update dependencies
1.2.262025-10-2968958Update dependencies
1.2.252025-10-2768629Fix Pagination for chats and agent_timeline streams
1.2.242025-10-2268591Add suggestedStreams
1.2.232025-10-2267607Handle 404 errors for deleted records in all streams
1.2.222025-10-2168440Update dependencies
1.2.212025-10-1468020Update dependencies
1.2.202025-10-0767238Update dependencies
1.2.192025-09-3066845Update dependencies
1.2.182025-09-2466459Update dependencies
1.2.172025-09-0965491Update dependencies
1.2.162025-08-1064864Update dependencies
1.2.152025-08-0264305Update dependencies
1.2.142025-07-2664053Update dependencies
1.2.132025-07-2063650Update dependencies
1.2.122025-07-1263177Update dependencies
1.2.112025-07-0562677Update dependencies
1.2.102025-06-2862247Update dependencies
1.2.92025-06-2161751Update dependencies
1.2.82025-06-1561248Update dependencies
1.2.72025-05-2460782Update dependencies
1.2.62025-05-1059993Update dependencies
1.2.52025-05-0458949Update dependencies
1.2.42025-04-1958028Update dependencies
1.2.32025-04-0557404Update dependencies
1.2.22025-03-2956850Update dependencies
1.2.12025-03-2256345Update dependencies
1.2.02025-03-1047319Migrate to Manifest-only
1.1.12025-03-0954110Update dependencies
1.1.02025-03-0354151Migrate to incrementalcursors
1.0.42025-02-0153081Update dependencies
1.0.32025-01-2551942Update dependencies
1.0.22025-01-2252065Pinned airbyte-cdk version to 0.72.2
1.0.12025-01-1143728Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
1.0.02024-11-0444898Migrate to new base url
0.3.12024-06-0639260[autopull] Upgrade base image to v1.2.2
0.3.02024-03-0735867Migrated to YamlDeclarativeSource (Low-code) Airbyte CDK
0.2.22024-02-1235185Manage dependencies with Poetry.
0.2.12023-10-2031643Upgrade base image to airbyte/python-connector-base:1.1.0
0.2.02023-10-1130526Use the python connector base image, remove dockerfile and implement build_customization.py
0.1.142023-02-1024190Fix remove too high min/max from account stream
0.1.132023-02-1022819Specified date formatting in specification
0.1.122023-01-2722026Set AvailabilityStrategy for streams explicitly to None
0.1.112022-10-1817745Add Engagements Stream and fix infity looping
0.1.102022-09-2817326Migrate to per-stream states.
0.1.92022-08-2315879Corrected specification and stream schemas to support backward capability
0.1.82022-06-2813387Add state checkpoint to allow long runs
0.1.72022-05-2512883Pass timeout in request to prevent a stuck connection
0.1.62021-12-157313Add support of OAuth 2.0 authentication. Fixed the issue with created_at can now be null for bans stream
0.1.52021-12-068425Update title, description fields in spec
0.1.42021-11-228166Make Chats stream incremental + add tests for all streams
0.1.32021-10-217210Chats stream is only getting data from first page
0.1.22021-08-175476Correct field unread to boolean type
0.1.12021-06-093973Add AIRBYTE_ENTRYPOINT for Kubernetes support
0.1.02021-05-033088Initial release
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.