How to register OAuth App for Zoho / ManageEngine API

Introduction

In this article, we will show you steps to register OAuth App for Zoho API and use it ZappySys Product. The steps listed here can be used for Zoho Products like CRM or ManagedEngine Products like ServiceDesk (ManageEngine is Zoho’s subsidary). For detailed steps check Zoho’s link here.

Register OAuth App in Zoho

1. Go to Zoho API Console
2. Click on Add Client  link
   
3. Click on Server-Based App option
   
4. When prompted enter following
   1. Your APP NAME
   2. Your company Homepage URL (any)
   3. Redirect URL (We suggest you use https://zappysys.com/oauth )
   4. Click CREATE
5. After you create app you will see ClientID and ClientSecret (Copy them somewhere safe location). You will need this to enter on OAuth UI
   

Using Zoho OAuth in ZappySys Connection

Now last step is using 3 pieces on ZappySys OAuth Connection UI (same UI in ODBC PowerPack or SSIS PowerPack Products)

1. Depending which Product you are using find out OAuth Connection UI Edit / New Connection option and enter below
2. On General Page enter
   1. ClientID,
   2. ClientSecret
   3. Scopes (Check API help page to find these.. each API requires different scope)
   4. Authorization URL and Token URL as below (if its US Region) . For Other regions refer this article to get URL https://accounts.zoho.com/oauth/v2/auth https://accounts.zoho.com/oauth/v2/token
3. Now go to Advanced Page and enter below
   1. Callback URL (exact same URL you configured in previous section)
      We suggest to use : https://zappysys.com/oauth
   2. Extra Auth Attributes like below
      access_type=offline&prompt=consent

      

4. Now go to General Tab again and click >>Generate Token<<
5. Close Popup Browser and use Full Browser when Prompted
6. Follow the steps … If successful you will see Access Token and Refresh Token extracted on the OAuth Connection UI