Zoho Bigin
Overview
Pre-built tooling
Pre-built integrations
No pre-built integration yet (time to contribute: <48h)
Access requirements
Pre-Requisites | Status | Comment |
---|---|---|
Paid dev account | ✅ Not required | Free Zoho account is sufficient for development. |
Paid test account | ✅ Not required | Free Zoho account is sufficient for testing. |
Partnership | ✅ Not required | |
App review | ✅ Not required | No review process for OAuth apps. |
Security audit | ✅ Not required |
Setup guide
Follow the general Zoho OAuth setup guide to create your OAuth application. When selecting scopes, make sure to include the Bigin-specific scopes listed in the Common Scopes section below.
Useful links
- Zoho API Console
- Zoho Developer Hub
- OAuth 2.0 Overview
- Server-based Applications
- Get Authorization Code
- Get Access Token
- Refresh Access Token
- Multi DC Support
- OAuth Scopes
Bigin-specific links
Common Scopes
- ZohoBigin.modules.ALL - Access to all Bigin modules
- ZohoBigin.settings.ALL - Access to all Bigin settings
- ZohoBigin.users.ALL - Access to all Bigin users
- ZohoBigin.org.ALL - Access to organization-level data
- ZohoBigin.notifications.READ - Read access to notifications
API gotchas
-
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. -
Zoho has rate limits that vary by service. Check the specific service documentation for details.
-
If your application needs to access multiple Zoho services, you need to request scopes for each service during the authorization process.
-
For production applications, consider implementing multi-datacenter support to handle users from different regions.
Bigin-specific gotchas
- You can make your OAuth app cross-data-centers with these instructions. This means that a single OAuth app will be able to query the Zoho API for Zoho accounts from the US, EU, etc.
- Bigin API has a rate limit of 10,000 API requests per day per organization.