Overview

This article walks you through creating a Zoho Desk OAuth application and entering its credentials in the Horizon onboarding wizard.

Prerequisites

• Administrator access to your Zoho Desk account
• The Horizon onboarding wizard open and on the Connect step

Steps

Part 1: Create a Self Client in Zoho API Console

1. Go to api-console.zoho.com and sign in with your Zoho administrator account.
2. Click Add Client and select Self Client.
3. Click Create to confirm. Your Client ID and Client Secret will be displayed — copy both and keep them handy.

Part 2: Generate an Authorization Code

1. In the Self Client, click the Generate Code tab.
2. In the Scope field, paste the following scopes exactly as shown:

   Desk.tickets.READ,Desk.tickets.WRITE,Desk.search.READ,Desk.contacts.READ,Desk.accounts.READ,Desk.agents.READ,Desk.settings.READ,Desk.basic.READ

3. Set Time Duration to 10 minutes.
4. Enter a description (e.g., Horizon integration) and click Create.
5. Copy the generated code — it expires in 10 minutes, so complete the next part promptly.

Part 3: Enter Credentials in Horizon

1. In the Horizon onboarding wizard, go to the Connect step and select Zoho Desk as your helpdesk.
2. Enter your Client ID and Client Secret from Part 1.
3. Paste the authorization code from Part 2 into the Authorization Code field.
4. Click Fetch Organizations. Horizon exchanges the code for tokens and loads your Zoho Desk organizations.
5. Select your organization from the Organization dropdown.
6. Click Test Connection to verify the credentials.
7. Once the test succeeds, click Next to continue.

Result

After a successful connection test, Horizon begins discovering your Zoho Desk fields and syncing your ticket data.

Related Articles

• Self Client Overview — Zoho OAuth 2.0
• Self Client: Authorization Code Flow — Zoho OAuth 2.0
• Register Your App — Zoho OAuth 2.0