This page guides you through setting up the Zendesk Support source connector.
- Locate your Zendesk subdomain found in your account URL. For example, if your account URL is
https://{MY_SUBDOMAIN}.zendesk.com/, thenMY_SUBDOMAINis your subdomain. - (For Airbyte Open Source) Find the email address associated with your Zendesk account. Also, generate an API token for the account.
- Log into your Airbyte Cloud or Airbyte Open Source account.
- Click Sources and then click + New source.
- On the Set up the source page, select Zendesk Support from the Source type dropdown.
- Enter a name for your source.
- For Subdomain, enter your Zendesk subdomain.
- For Start date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. The data added on and after this date will be replicated. If this field is blank, Airbyte will replicate all data.
- You can use OAuth or an API key to authenticate your Zendesk Support account. We recommend using OAuth for Airbyte Cloud and an API key for Airbyte Open Source.
- To authenticate using OAuth for Airbyte Cloud, click Authenticate your Zendesk Support account to sign in with Zendesk Support and authorize your account.
- To authenticate using an API key for Airbyte Open Source, select API key from the Authentication dropdown and enter your API key. Enter the Email associated with your Zendesk Support account.
- Click Set up source.
The Zendesk Support source connector supports the following sync modes:
- Full Refresh - overwrite
- Full Refresh - append
- Incremental - append
The Zendesk Support source connector supports the following streams:
- Brands
- Custom Roles
- Groups
- Group Memberships
- Macros
- Organizations
- Satisfaction Ratings
- Schedules
- SLA Policies
- Tags
- Tickets
- Ticket Audits
- Ticket Comments
- Ticket Fields
- Ticket Forms
- Ticket Metrics
- Ticket Metric Events
- Users
The connector is restricted by normal Zendesk requests limitation.
The Zendesk connector ideally should not run into Zendesk API limitations under normal usage. Create an issue if you see any rate limit issues that are not automatically retried successfully.
| Version | Date | Pull Request | Subject |
|---|---|---|---|
0.2.16 |
2022-09-28 | 17326 | Migrate to per-stream states. |
0.2.15 |
2022-08-03 | 15233 | Added subscription plan check on streams discovery step to remove streams that are not accessible for fetch due to subscription plan restrictions |
0.2.14 |
2022-07-27 | 15036 | Convert ticket_audits.previous_value values to string |
0.2.13 |
2022-07-21 | 14829 | Convert tickets.custom_fields values to string |
0.2.12 |
2022-06-30 | 14304 | Fixed Pagination for Group Membership stream |
0.2.11 |
2022-06-24 | 14112 | Fixed "Retry-After" non integer value |
0.2.10 |
2022-06-14 | 13757 | Fixed the bug with TicketMetrics stream, HTTP Error 429, caused by lots of API requests |
0.2.9 |
2022-05-27 | 13261 | Bugfix for the unhandled ChunkedEncodingError and ConnectionError |
0.2.8 |
2022-05-20 | 13055 | Fixed minor issue for stream ticket_audits schema |
0.2.7 |
2022-04-27 | 12335 | Adding fixtures to mock time.sleep for connectors that explicitly sleep |
0.2.6 |
2022-04-19 | 12122 | Fixed the bug when only 100,000 Users are synced 11895 and fixed bug when start_date is not used on user stream 12059. |
0.2.5 |
2022-04-05 | 11727 | Fixed the bug when state was not parsed correctly |
0.2.4 |
2022-04-04 | 11688 | Small documentation corrections |
0.2.3 |
2022-03-23 | 11349 | Fixed the bug when Tickets stream didn't return deleted records |
0.2.2 |
2022-03-17 | 11237 | Fixed the bug when TicketComments stream didn't return all records |
0.2.1 |
2022-03-15 | 11162 | Added support of OAuth2.0 authentication method |
0.2.0 |
2022-03-01 | 9456 | Update source to use future requests |
0.1.12 |
2022-01-25 | 9785 | Add additional log messages |
0.1.11 |
2021-12-21 | 8987 | Update connector fields title/description |
0.1.9 |
2021-12-16 | 8616 | Adds Brands, CustomRoles and Schedules streams |
0.1.8 |
2021-11-23 | 8050 | Adds TicketMetricEvents stream |
0.1.7 |
2021-11-23 | 8058 | Added support of AccessToken authentication |
0.1.6 |
2021-11-18 | 8050 | Fix wrong types for schemas, add TypeTransformer |
0.1.5 |
2021-10-26 | 7679 | Add ticket_id and ticket_comments |
0.1.4 |
2021-10-26 | 7377 | Fix initially_assigned_at type in ticket metrics |
0.1.3 |
2021-10-17 | 7097 | Corrected the connector's specification |
0.1.2 |
2021-10-16 | 6513 | Fixed TicketComments stream |
0.1.1 |
2021-09-02 | 5787 | Fixed incremental logic for the ticket_comments stream |
0.1.0 |
2021-07-21 | 4861 | Created CDK native zendesk connector |