Zendesk Chat

Availability

Core Standard Pro Enterprise Flex Self-Managed Enterprise PyAirbyte

Support Level

Airbyte

Connector Version

1.2.20 (last updated 3 days ago)

Sync Success Rate

Usage Rate

Definition ID

40d24d0f-b8f9-4fe0-9e6c-b06c0f3f45e4

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

Reference

Config fields reference

Field

Type

Property name

string

start_date

string

subdomain

object

credentials

Changelog

Expand to review

Version	Date	Pull Request	Subject
1.2.20	2025-10-07	67238	Update dependencies
1.2.21	2025-10-10	67607	Handle 404 errors for deleted records in chats and agent_timeline streams

| 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 |