Skip to main content

How to switch your Fin for Zendesk connection from API keys to OAuth

Switch your Fin for Zendesk tickets and messaging connections from API keys to OAuth before January 31st, 2027.

Use this article to move your Zendesk tickets and Zendesk messaging connections from API keys to OAuth (Open Authorization, Zendesk's secure sign-in) by January 31st, 2027. It's for admins who set up Fin for Zendesk with API keys.

You need the Can install, configure and delete apps permission in Intercom and an admin account in Zendesk.

Important: Don't delete or turn off your existing Conversations API key in Zendesk until the switch for Zendesk messaging has finished. Fin uses it one last time to move your messaging channels over to the new connection.


Why do you need to switch from API keys to OAuth?

Zendesk is retiring API tokens and API keys (credentials you copy from Zendesk and paste into Fin) for apps that connect to Zendesk. Fin now connects with OAuth: you sign in to Zendesk and approve access, and there are no keys to copy or manage.

If you set up Fin for Zendesk with API keys, switch both connections to OAuth by January 31st, 2027. Your current connections keep working in the meantime.


How to check which Zendesk connections use API keys

Fin has two Zendesk connections, and both are on the Connect page:

  • Zendesk tickets (Connect to Zendesk): Fin uses it to read and reply to Zendesk tickets.

  • Zendesk messaging (Connect to Zendesk Sunshine): Fin uses it for Zendesk Messaging, and for hand-offs from the Fin Messenger to your Zendesk agents.

If a connection still uses an API key, a banner at the top of Fin asks you to reconnect by January 31st, 2027. That connection on the Connect page also shows API key: reconnect by 31 Jan 2027. Select Reconnect on the banner to go straight to the connection that needs it.


What do you need before you start?

  • The Can install, configure and delete apps permission in Intercom.

  • An admin account for the Zendesk account Fin is already connected to.

  • Popups allowed for app.intercom.com in your browser.


How to switch Zendesk tickets to OAuth

  1. Go to Connect in the left nav.

  2. Expand Connect to Zendesk.

  3. Select Manage Connection.

  4. Select Reconnect.

  5. A popup window opens. Sign in to Zendesk with your admin account and approve access.

  6. The popup closes and you're returned to Fin. The banner about Zendesk tickets disappears.


How to switch Zendesk messaging to OAuth

Zendesk messaging needs the Zendesk tickets connection in place first. A Zendesk tickets connection that still uses an API token is enough, but we recommend switching it first.

  1. Go to Connect in the left nav.

  2. Expand Connect to Zendesk Sunshine.

  3. Select Manage Connection.

  4. Select Reconnect.

  5. A popup window opens. Sign in to the same Zendesk account and approve access.

  6. The popup closes and you're returned to Fin.


What stays the same after you switch?

  • Zendesk tickets: Fin updates your existing connection. Your workflows, your Fin Zendesk agent, Fin's Zendesk triggers and your data sync settings stay as they are.

  • Zendesk messaging: Fin keeps responding on the same messaging channels, and your workflows stay as they are.

  • You don't need to set anything up again.


How to troubleshoot the switch to OAuth

  • Check that you have the Can install, configure and delete apps permission in Intercom, and that you signed in to Zendesk as an admin.

  • Check that popups are allowed for app.intercom.com.

  • If the popup shows Zendesk connection failed, or the banner is still there, select Reconnect again. Your existing connection keeps working in the meantime.

  • If Fin stops replying on a Zendesk messaging channel after a failed attempt, go to AI > AI agents > Marketplace bots in Zendesk, select Fin AI Agent, and check that the channel is selected.


💡Tip

Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts


Did this answer your question?