Skip to main content

Zendesk Support Migration Guide

The pagination strategy has been changed from Offset to Cursor-Based. It is necessary to reset the stream.

Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:

  1. Select Settings in the main navbar.
    • Select Sources.
  2. Find Zendesk Support in the list of connectors.
note

You will see two versions listed, the current in-use version and the latest version available.

  1. Select Change to update your OSS version to the latest available version.
  1. Select Sources in the main navbar.
  2. Select the instance of the connector you wish to upgrade.
note

Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.

  1. Select Upgrade
    • Follow the prompt to confirm you are ready to upgrade to the new version.
  1. Select Connections in the main nav bar.
    • Select the connection(s) affected by the update.
  2. Select the Replication tab.
    • Select Refresh source schema.
    • Select OK.
note

Any detected schema changes will be listed for your review.

  1. Select Save changes at the bottom of the page.
    • Ensure the Refresh affected streams option is checked.
note

Depending on destination type you may not be prompted to refresh your data. See below.

  1. Select Save connection.
note

This will refresh the data in your destination and initiate a fresh sync.

For more information on refreshes your data in Airbyte, see this page.

cursor_field for TicketsMetric stream is changed to generated_timestamp. It is necessary to refresh the data and schema for the affected stream.

Stream NameAdded Fields
TicketMetricsgenerated_timestamp

Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:

  1. Select Settings in the main navbar.
    • Select Sources.
  2. Find Zendesk Support in the list of connectors.
note

You will see two versions listed, the current in-use version and the latest version available.

  1. Select Change to update your OSS version to the latest available version.
  1. Select Sources in the main navbar.
  2. Select the instance of the connector you wish to upgrade.
note

Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.

  1. Select Upgrade
    • Follow the prompt to confirm you are ready to upgrade to the new version.
  1. Select Connections in the main nav bar.
    • Select the connection(s) affected by the update.
  2. Select the Replication tab.
    • Select Refresh source schema.
    • Select OK.
note

Any detected schema changes will be listed for your review.

  1. Select Save changes at the bottom of the page.
    • Ensure the Refresh affected streams option is checked.
note

Depending on destination type you may not be prompted to refresh your data. See below.

  1. Select Save connection.
note

This will refresh the data in your destination and initiate a fresh sync.

For more information on refreshes your data in Airbyte, see this page.

Stream Deleted Tickets is removed. You may need to refresh the connection schema (skipping the data clearing), and running a sync. Alternatively, you can clear your data.

cursor_field for Tickets stream is changed to generated_timestamp. For a smooth migration, you should refresh your stream. Alternatively, you can clear your data.