Articles in this section

Zendesk Chat OAuth Process

This document outlines the process required to obtain OAuth access to an organization’s Zendesk Chat instance. One of the applications of ZD Chat access is to surface the list of chat departments for Handoff routing in Solve Widget

Configuring Zendesk Client

  • 💡 Note: Create the API Client from the ZD chat page ([yourdomain] and not the ZD admin page (
  • Open the chat app. Navigate to Settings → Account → API & SDKs → Add API Client

Screenshot 2023-11-02 at 11.50.56 AM.png

  • Add an API client with the following parameters:
    • Client Name: Forethought Chat OAuth Client
    • Company: Forethought Technologies
    • Redirect URLS:

Screenshot 2023-11-02 at 11.46.07 AM.png

  • A popup with Client ID and Client Secret will show, make sure you save them, you will only see them once. Once this is done, move on to the next steps on the Forethought side. 

Screenshot 2023-11-02 at 11.58.17 AM.png


Configure Zendesk Chat Integration

  • Go to the Forethought dashboard, visit Settings -> Integrations, search "Zendesk Chat", input the following and click Connect. 
    • Domain:
    • Client ID: the client ID generated from the previous step on the Zendesk Chat portal
    • Client Secret: the client secret generated from the previous step on the Zendesk Chat portal

Screenshot 2023-11-02 at 12.00.53 PM.png

  • You will be redirected to Zendesk chat's Oauth page, click "Allow" to proceed.

Screenshot 2023-11-02 at 12.01.11 PM.png

  • If the OAuth process is successful, you will see a success page on the Forethought side, you may close this page or wait for 15 seconds before the page will be automatically closed.

Screenshot 2023-11-02 at 11.34.00 AM.png

  • That's it, your Zendesk Chat is now fully connected. 

Was this article helpful?
0 out of 0 found this helpful


  • Need help?

    Click here to submit a support request. We are here to assist you.

  • Business hours

    Monday to Friday 8am - 5pm PST excluding US holidays

  • Contact us