Steps
-
Create an Application in the Zoho API Console
- Go to the Zoho API Console
- Create a Server-based Application (for backend redirect URIs)
- Note: For browser-based apps, choose Client-based Application instead
-
Fill Out Application Details
- Client Name: e.g.,
My CRM Integration - Homepage URL: Your application’s base URL
- Authorized Redirect URIs: Your OAuth callback URL
- Client Name: e.g.,
-
Get Client ID and Client Secret
- After saving, Zoho will generate your Client ID and Client Secret
- Copy both values immediately
-
Configure Scopes
- Zoho’s Developer Console doesn’t have a manual scope selector
- Scopes are specified when making the authorization request
- Default/common scopes:
ZohoCRM.modules.ALL— Access all modulesZohoCRM.settings.ALL— Access all settingsZohoCRM.notifications.ALL— Access notificationsZohoCRM.users.ALL— Access user management
- Additional scopes:
ZohoCRM.contacts.ALL— Contact managementZohoCRM.deals.ALL— Deal/sales pipelineZohoCRM.tasks.ALL— Task managementZohoCRM.reports.ALL— Reports and analyticsZohoCRM.org.ALL— Organization detailsZohoCRM.bulk.ALL— Bulk read/write APIsZohoCRM.files.ALL— Attachments and filesZohoCRM.coql.READ— COQL queriesZohoCRM.functions.ALL— Custom functions/workflows
Key Details
- API Console: https://api-console.zoho.com/
- Auth Type: OAuth 2.0
- Authorization URL:
https://accounts.zoho.com/oauth/v2/auth - Token URL:
https://accounts.zoho.com/oauth/v2/token - Base API URL:
https://www.zohoapis.com/crm/v2/ - Credentials Location: API Console → Application details
- OAuth Terminology Reference: https://www.zoho.com/accounts/protocol/oauth-terminology.html
- Scopes Documentation: https://www.zoho.com/crm/developer/docs/api/v2/scopes.html
- Note: Zoho has regional data centers — ensure your API base URL matches your account region (e.g.,
.com,.eu,.in,.com.au)