airbyte/docs/integrations/sources/zendesk-chat.md

Zendesk Chat

This page contains the setup guide and reference information for the Zendesk Chat source connector.

Prerequisites

• A Zendesk Account with permission to access data from accounts you want to sync.

• (Airbyte Open Source) An Access Token (https://developer.zendesk.com/rest_api/docs/chat/auth). We recommend creating a restricted, read-only key specifically for Airbyte access to allow you to control which resources Airbyte should be able to access.

Setup guide

For Airbyte Cloud:

1. Log into your Airbyte Cloud account.
2. Click Sources and then click + New source.
3. On the Set up the source page, select Zendesk Chat from the Source type dropdown.
4. Enter the name for the Zendesk Chat connector.
5. If you access Zendesk Chat from a Zendesk subdomain, enter the Subdomain.
6. For Start Date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. The data added on and after this date will be replicated.
7. Click Authenticate your Zendesk Chat account. Log in and authorize your Zendesk Chat account.
8. Click Set up source.

For Airbyte Open Source:

1. Navigate to the Airbyte Open Source dashboard.
2. Click Sources and then click + New source.
3. On the Set up the source page, select Zendesk Chat from the Source type dropdown.
4. Enter the name for the Zendesk Chat connector.
5. If you access Zendesk Chat from a Zendesk subdomain, enter the Subdomain.
6. For Start Date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. The data added on and after this date will be replicated.
7. For Authorization Method, select Access Token from the dropdown and enter your Zendesk access token.
8. Click Set up source.

Supported sync modes

The Zendesk Chat source connector supports the following sync modes:

• Full Refresh - Overwrite
• Full Refresh - Append
• Incremental - Append
• Incremental - Append + Deduped

Supported Streams

• Accounts
• Agents (Incremental)
• Agent Timelines (Incremental)
• Chats
• Shortcuts
• Triggers
• Bans (Incremental)
• Departments
• Goals
• Skills
• Roles
• Routing Settings

Performance considerations

The connector is restricted by Zendesk's requests limitation.

Data type map

Integration Type	Airbyte Type
string	string
number	number
array	array
object	object

Changelog

Expand to review

Version	Date	Pull Request	Subject
1.2.28	2025-11-25	70128	Update dependencies
1.2.27	2025-11-18	69513	Update dependencies
1.2.26	2025-10-29	68958	Update dependencies
1.2.25	2025-10-27	68629	Fix Pagination for chats and agent_timeline streams
1.2.24	2025-10-22	68591	Add suggestedStreams
1.2.23	2025-10-22	67607	Handle 404 errors for deleted records in all streams
1.2.22	2025-10-21	68440	Update dependencies
1.2.21	2025-10-14	68020	Update dependencies
1.2.20	2025-10-07	67238	Update dependencies
1.2.19	2025-09-30	66845	Update dependencies
1.2.18	2025-09-24	66459	Update dependencies
1.2.17	2025-09-09	65491	Update dependencies
1.2.16	2025-08-09	64864	Update dependencies
1.2.15	2025-08-02	64305	Update dependencies
1.2.14	2025-07-26	64053	Update dependencies
1.2.13	2025-07-20	63650	Update dependencies
1.2.12	2025-07-12	63177	Update dependencies
1.2.11	2025-07-05	62677	Update dependencies
1.2.10	2025-06-28	62247	Update dependencies
1.2.9	2025-06-21	61751	Update dependencies
1.2.8	2025-06-15	61248	Update dependencies
1.2.7	2025-05-24	60782	Update dependencies
1.2.6	2025-05-10	59993	Update dependencies
1.2.5	2025-05-04	58949	Update dependencies
1.2.4	2025-04-19	58028	Update dependencies
1.2.3	2025-04-05	57404	Update dependencies
1.2.2	2025-03-29	56850	Update dependencies
1.2.1	2025-03-22	56345	Update dependencies
1.2.0	2025-03-10	47319	Migrate to Manifest-only
1.1.1	2025-03-09	54110	Update dependencies
1.1.0	2025-03-03	54151	Migrate to incrementalcursors
1.0.4	2025-02-01	53081	Update dependencies
1.0.3	2025-01-25	51942	Update dependencies
1.0.2	2025-01-22	52065	Pinned airbyte-cdk version to 0.72.2
1.0.1	2025-01-11	43728	Starting 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.0	2024-11-04	44898	Migrate to new base url
0.3.1	2024-06-06	39260	[autopull] Upgrade base image to v1.2.2
0.3.0	2024-03-07	35867	Migrated to YamlDeclarativeSource (Low-code) Airbyte CDK
0.2.2	2024-02-12	35185	Manage dependencies with Poetry.
0.2.1	2023-10-20	31643	Upgrade base image to airbyte/python-connector-base:1.1.0
0.2.0	2023-10-11	30526	Use the python connector base image, remove dockerfile and implement build_customization.py
0.1.14	2023-02-10	24190	Fix remove too high min/max from account stream
0.1.13	2023-02-10	22819	Specified date formatting in specification
0.1.12	2023-01-27	22026	Set AvailabilityStrategy for streams explicitly to None
0.1.11	2022-10-18	17745	Add Engagements Stream and fix infity looping
0.1.10	2022-09-28	17326	Migrate to per-stream states.
0.1.9	2022-08-23	15879	Corrected specification and stream schemas to support backward capability
0.1.8	2022-06-28	13387	Add state checkpoint to allow long runs
0.1.7	2022-05-25	12883	Pass timeout in request to prevent a stuck connection
0.1.6	2021-12-15	7313	Add support of OAuth 2.0 authentication. Fixed the issue with created_at can now be null for bans stream
0.1.5	2021-12-06	8425	Update title, description fields in spec
0.1.4	2021-11-22	8166	Make Chats stream incremental + add tests for all streams
0.1.3	2021-10-21	7210	Chats stream is only getting data from first page
0.1.2	2021-08-17	5476	Correct field unread to boolean type
0.1.1	2021-06-09	3973	Add AIRBYTE_ENTRYPOINT for Kubernetes support
0.1.0	2021-05-03	3088	Initial release