Skip to main content

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 Open Source) 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 Open Source 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 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.
  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 Sync | Append
  • Incremental Sync | Deduped History

Supported streams​

note

There are two types of incremental sync:

  1. Incremental (standard server-side, where API returns only the data updated or generated since the last sync)
  2. Client-Side Incremental (API returns all available data and connector filters out only new records) :::

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​

VersionDatePull RequestSubject
0.10.22023-07-1928487Remove extra page from params
0.10.12023-07-1028096Replace offset pagination with cursor pagination
0.10.02023-07-0627991add streams: PostVotes, PostCommentVotes
0.9.02023-07-0527961Add stream: Post Comments
0.8.12023-06-2727765Bugfix: Nonetype error while syncing more then 100000 organizations
0.8.02023-06-0927156Add stream Posts
0.7.02023-06-2727436Add Ticket Skips stream
0.6.02023-06-2727450Add Skill Based Routing streams
0.5.02023-06-2627735License Update: Elv2 stream stream
0.4.02023-06-1627431Add Organization Memberships stream
0.3.12023-06-0226945Make Ticket Metrics stream to use cursor pagination
0.3.02023-05-2326347Add stream Audit Logs logs`
0.2.302023-05-2326414Added missing handlers when empty json or JSONDecodeError is received
0.2.292023-04-1825214Add missing fields to Tickets stream
0.2.282023-03-2124053Fix stream sla_policies schema data type error (events.value)
0.2.272023-03-2222817Specified date formatting in specification
0.2.262023-03-2024252Handle invalid start_date when checking connection
0.2.252023-02-2822308Add AvailabilityStrategy for all streams
0.2.242023-02-1723246Handle StartTimeTooRecent error for Tickets stream
0.2.232023-02-1523035Handle 403 Error
0.2.222023-02-1422483Fix test; handle 400 error
0.2.212023-01-2722027Set AvailabilityStrategy for streams explicitly to None
0.2.202022-12-2820900Remove synchronous time.sleep, add logging, reduce backoff time
0.2.192022-12-0919967Fix reading response for more than 100k records
0.2.182022-11-2919432Revert changes from version 0.2.15, use a test read instead
0.2.172022-11-2419792Transform ticket_comments.via "-" to null
0.2.162022-09-2817326Migrate to per-stream states.
0.2.152022-08-0315233Added subscription plan check on streams discovery step to remove streams that are not accessible for fetch due to subscription plan restrictions
0.2.142022-07-2715036Convert ticket_audits.previous_value values to string
0.2.132022-07-2114829Convert tickets.custom_fields values to string
0.2.122022-06-3014304Fixed Pagination for Group Membership stream
0.2.112022-06-2414112Fixed "Retry-After" non integer value
0.2.102022-06-1413757Fixed the bug with TicketMetrics stream, HTTP Error 429, caused by lots of API requests
0.2.92022-05-2713261Bugfix for the unhandled ChunkedEncodingError and ConnectionError
0.2.82022-05-2013055Fixed minor issue for stream ticket_audits schema
0.2.72022-04-2712335Adding fixtures to mock time.sleep for connectors that explicitly sleep
0.2.62022-04-1912122Fixed 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.52022-04-0511727Fixed the bug when state was not parsed correctly
0.2.42022-04-0411688Small documentation corrections
0.2.32022-03-2311349Fixed the bug when Tickets stream didn't return deleted records
0.2.22022-03-1711237Fixed the bug when TicketComments stream didn't return all records
0.2.12022-03-1511162Added support of OAuth2.0 authentication method
0.2.02022-03-019456Update source to use future requests
0.1.122022-01-259785Add additional log messages
0.1.112021-12-218987Update connector fields title/description
0.1.92021-12-168616Adds Brands, CustomRoles and Schedules streams
0.1.82021-11-238050Adds TicketMetricEvents stream
0.1.72021-11-238058Added support of AccessToken authentication
0.1.62021-11-188050Fix wrong types for schemas, add TypeTransformer
0.1.52021-10-267679Add ticket_id and ticket_comments
0.1.42021-10-267377Fix initially_assigned_at type in ticket metrics
0.1.32021-10-177097Corrected the connector's specification
0.1.22021-10-166513Fixed TicketComments stream
0.1.12021-09-025787Fixed incremental logic for the ticket_comments stream
0.1.02021-07-214861Created CDK native zendesk connector