From afe82eb99fa2b0ffd7075cd95fd1fb78f31c64e6 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Tue, 27 Jan 2026 20:13:19 +0000 Subject: [PATCH 1/2] docs(source-zendesk-support): improve OAuth authentication documentation - Update authentication section to list all three methods (OAuth 2.0 with Refresh Token, API Token, OAuth 2.0 Legacy) - Add information about Zendesk's OAuth refresh token deadline (April 30, 2026) - Enhance migration guide for 5.0.0 with context about Zendesk's OAuth changes - Add link to Zendesk's OAuth refresh token announcement Co-Authored-By: unknown <> --- .../sources/zendesk-support-migrations.md | 20 ++++++++++++++----- docs/integrations/sources/zendesk-support.md | 13 +++++++----- 2 files changed, 23 insertions(+), 10 deletions(-) diff --git a/docs/integrations/sources/zendesk-support-migrations.md b/docs/integrations/sources/zendesk-support-migrations.md index bc81b79ac7fe..efc79f2f43fe 100644 --- a/docs/integrations/sources/zendesk-support-migrations.md +++ b/docs/integrations/sources/zendesk-support-migrations.md @@ -8,14 +8,24 @@ This version adds OAuth2.0 with refresh token support. Users who authenticate vi ### What changed -The OAuth authentication flow has been updated to support Zendesk's new grant-type tokens with rotating refresh tokens. The legacy OAuth2.0 option has been renamed to "OAuth2.0 (Legacy)" and a new "OAuth2.0 with Refresh Token" option has been added. +Zendesk announced support for OAuth refresh token grant type starting April 30, 2025, with a requirement for all customers to adopt this flow by April 30, 2026. The connector has been updated to support this new authentication flow. + +The OAuth authentication flow now uses rotating refresh tokens. When the connector refreshes an access token, Zendesk returns a new refresh token and invalidates the previous one. This provides enhanced security but requires the connector to properly handle token rotation. + +The legacy OAuth2.0 option has been renamed to "OAuth2.0 (Legacy)" and a new "OAuth2.0 with Refresh Token" option has been added. + +### Who is affected + +This change affects users who authenticate via OAuth. Users who authenticate with API tokens are not affected. ### Migration steps -1. Go to your Zendesk Support connection settings in Airbyte -2. If you are using OAuth authentication, you will need to re-authenticate -3. Select "OAuth2.0 with Refresh Token" as the authentication method -4. Complete the OAuth flow to authorize the connector +1. Go to your Zendesk Support connection settings in Airbyte. +2. If you are using OAuth authentication, you will need to re-authenticate. +3. Select "OAuth2.0 with Refresh Token" as the authentication method. +4. Complete the OAuth flow to authorize the connector. + +For more information about Zendesk's OAuth changes, see [Zendesk's OAuth refresh token announcement](https://support.zendesk.com/hc/en-us/articles/9182123625370). ### Connector upgrade guide diff --git a/docs/integrations/sources/zendesk-support.md b/docs/integrations/sources/zendesk-support.md index 9cbb8c4a657a..6c3f5ab6fdd2 100644 --- a/docs/integrations/sources/zendesk-support.md +++ b/docs/integrations/sources/zendesk-support.md @@ -15,16 +15,19 @@ This page contains the setup guide and reference information for the [Zendesk Su ## Set up Zendesk Support -The Zendesk Support source connector supports two authentication methods: +The Zendesk Support source connector supports the following authentication methods: -- OAuth 2.0 -- API token +- OAuth 2.0 with Refresh Token (recommended for Airbyte Cloud) +- API Token (recommended for Airbyte Open Source) +- OAuth 2.0 (Legacy) for existing connections + +Zendesk is transitioning to OAuth with rotating refresh tokens. All customers must adopt this new OAuth flow by April 30, 2026. For more information, see [Zendesk's OAuth refresh token announcement](https://support.zendesk.com/hc/en-us/articles/9182123625370). **For Airbyte Cloud:** -We highly recommend using OAuth to authenticate your Zendesk Support account, as it simplifies the setup process and allows you to authenticate [directly from the Airbyte UI](#set-up-the-zendesk-support-source-connector). +We highly recommend using OAuth 2.0 with Refresh Token to authenticate your Zendesk Support account, as it simplifies the setup process, allows you to authenticate [directly from the Airbyte UI](#set-up-the-zendesk-support-source-connector), and automatically handles token refresh with rotating refresh tokens. @@ -76,7 +79,7 @@ If you prefer to authenticate with OAuth for **Airbyte Open Source**, you can fo 5. You can use OAuth or an API token to authenticate your Zendesk Support account. -- **For Airbyte Cloud**: To authenticate using OAuth, select **OAuth 2.0** from the Authentication dropdown, then click **Authenticate your Zendesk Support account** to sign in with Zendesk Support and authorize your account. +- **For Airbyte Cloud**: To authenticate using OAuth, select **OAuth 2.0 with Refresh Token** from the Authentication dropdown, then click **Authenticate your Zendesk Support account** to sign in with Zendesk Support and authorize your account. This method uses rotating refresh tokens to automatically maintain your connection. - **For Airbyte Open Source**: To authenticate using an API key, select **API Token** from the Authentication dropdown and enter the API token you generated, as well as the email address associated with your Zendesk Support account. From 4c49c1994162f2b771f0d1dc2b776c54b560b2e1 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Tue, 27 Jan 2026 20:15:46 +0000 Subject: [PATCH 2/2] fix: correct link fragment to match actual heading Co-Authored-By: unknown <> --- docs/integrations/sources/zendesk-support.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/zendesk-support.md b/docs/integrations/sources/zendesk-support.md index 6c3f5ab6fdd2..a72d7c2df9bf 100644 --- a/docs/integrations/sources/zendesk-support.md +++ b/docs/integrations/sources/zendesk-support.md @@ -27,7 +27,7 @@ Zendesk is transitioning to OAuth with rotating refresh tokens. All customers mu **For Airbyte Cloud:** -We highly recommend using OAuth 2.0 with Refresh Token to authenticate your Zendesk Support account, as it simplifies the setup process, allows you to authenticate [directly from the Airbyte UI](#set-up-the-zendesk-support-source-connector), and automatically handles token refresh with rotating refresh tokens. +We highly recommend using OAuth 2.0 with Refresh Token to authenticate your Zendesk Support account, as it simplifies the setup process, allows you to authenticate [directly from the Airbyte UI](#set-up-the-zendesk-support-connector-in-airbyte), and automatically handles token refresh with rotating refresh tokens.