Skip to main content
This guide shows you how to register your own app with Zoho CRM to obtain your OAuth credentials (client id & secret). These are required to let your users grant your app access to their Zoho CRM account.
1

Create a Zoho account

If you don’t already have one, go to Zoho’s signup page and create one.
2

Access the Zoho API Console

  1. Go to the Zoho API Console.
  2. Sign in with your Zoho account if prompted.
3

Create a new client

  1. In the API Console, click on the + ADD CLIENT button and select Server-based Applications as your client type.
  2. Fill in all the required information. For Authorized Redirect URIs enter https://api.nango.dev/oauth/callback
  3. Click Create to register your client. You will then receive a Client ID and Client Secret, which are required to configure your integration in Nango.
4

Configure Multi-DC

  1. On the Settings tab, check the option to use the same OAuth credentials for all data centers, this enables you to handle users from different regions
5

Next

Follow the Quickstart.

​
Important considerations

  • Zoho uses datacenter-specific URLs for authentication. Make sure to use the correct datacenter domain extension (com, eu, in, com.cn, com.au) based on where your user’s account is registered.
  • For production applications, consider implementing multi-datacenter support to handle users from different regions.
  • For specific scopes, refer to the API documentation to find the exact scopes needed per API and per method.

​
Common OAuth scopes

When configuring your Zoho CRM OAuth app, you may need the following scopes depending on your use case. See Zoho’s OAuth scopes documentation for the complete list.
ScopeDescription
ZohoCRM.modules.leads.ALLFull access to all Leads module actions (read, create, update, delete).
ZohoCRM.modules.contacts.ALLFull access to all Contacts module actions.
ZohoCRM.modules.accounts.ALLFull access to all Accounts module actions.
ZohoCRM.modules.deals.ALLFull access to all Deals module actions.
ZohoCRM.modules.campaigns.ALLFull access to all Campaigns module actions.
ZohoCRM.modules.tasks.ALLFull access to all Tasks module actions.
ZohoCRM.modules.cases.ALLFull access to all Cases module actions.
For more details on Zoho’s OAuth implementation, see Zoho’s OAuth 2.0 documentation.