Set up Zoho CRM with Tenklo
Register an OAuth app with Zoho CRM and connect it to Tenklo
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.
If you don't already have one, go to Zoho's signup page and create one.
- Go to the Zoho API Console.
- Sign in with your Zoho account if prompted.
- In the API Console, click on the + ADD CLIENT button and select Server-based Applications as your client type.
- Fill in all the required information. For Authorized Redirect URIs enter
https://api.tenklo.dev/oauth/callback - Click Create to register your client. You will then receive a Client ID and Client Secret, which are required to configure your integration in Tenklo.
- 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
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.
| Scope | Description |
|---|---|
ZohoCRM.modules.leads.ALL | Full access to all Leads module actions (read, create, update, delete). |
ZohoCRM.modules.contacts.ALL | Full access to all Contacts module actions. |
ZohoCRM.modules.accounts.ALL | Full access to all Accounts module actions. |
ZohoCRM.modules.deals.ALL | Full access to all Deals module actions. |
ZohoCRM.modules.campaigns.ALL | Full access to all Campaigns module actions. |
ZohoCRM.modules.tasks.ALL | Full access to all Tasks module actions. |
ZohoCRM.modules.cases.ALL | Full access to all Cases module actions. |
For more details on Zoho's OAuth implementation, see Zoho's OAuth 2.0 documentation.