Skip to content

Latest commit

 

History

History
87 lines (72 loc) · 12.2 KB

zendesk-support.md

File metadata and controls

87 lines (72 loc) · 12.2 KB
Raw

Zendesk Support

This page guides you through setting up the Zendesk Support source connector.

Prerequisites

  • Locate your Zendesk subdomain found in your account URL. For example, if your account URL is https://{MY_SUBDOMAIN}.zendesk.com/, then MY_SUBDOMAIN is your subdomain.
  • (For Airbyte OSS) Find the email address associated with your Zendesk account. Also, generate an API token for the account.

Set up the Zendesk Support source connector

  1. Log into your Airbyte Cloud or Airbyte OSS account.
  2. Click Sources and then click + New source.
  3. On the Set up the source page, select Zendesk Support from the Source type dropdown.
  4. Enter a name for your source.
  5. For Subdomain, enter your Zendesk 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. If this field is blank, Airbyte will replicate all data.
  7. 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 OSS.
    • 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 OSS, select API key from the Authentication dropdown and enter your API key. Enter the Email associated with your Zendesk Support account.
  8. Click Set up source.

Supported sync modes

The Zendesk Support source connector supports the following sync modes:

  • Full Refresh - overwrite
  • Full Refresh - append
  • Incremental - append

Supported streams

The Zendesk Support source connector supports the following streams:

Performance considerations

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.

Changelog

Version Date Pull Request Subject
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