Zoho Books
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 Books-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
Books-specific links
Common Scopes
- ZohoBooks.fullaccess.all - Full access to Books data
- ZohoBooks.contacts.READ - Read access to contacts
- ZohoBooks.contacts.CREATE - Create contacts
- ZohoBooks.contacts.UPDATE - Update contacts
- ZohoBooks.contacts.DELETE - Delete contacts
- ZohoBooks.invoices.READ - Read access to invoices
- ZohoBooks.invoices.CREATE - Create invoices
- ZohoBooks.invoices.UPDATE - Update invoices
- ZohoBooks.invoices.DELETE - Delete invoices
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.
Books-specific gotchas
- The Zoho Books API has region-specific endpoints. You need to use the correct endpoint based on the user’s region.
- 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.