# Zoho CRM — CRM API: overview

> Canonical URL: https://developers.apideck.com/apis/crm/zoho-crm/overview

Zoho makes it easy to get the complete picture of your sales cycle and stay on top of your business opportunities. Never lose another lead again.
- Status: live
- Authentication: oauth2

- **authentication note:** Authorization Code flow via Zoho Accounts.
- **consumer access level:** Any user whose profile has the Zoho CRM API Access permission (Administrators have it by default)
- **important to know:** Zoho runs nine data centres (US, EU, India, Australia, Japan, China, Canada, Saudi Arabia, UK). Your client needs Multi-DC enabled for every data centre your consumers' accounts live in, or their authorisation fails; the connector detects each consumer's data centre itself.
Zoho keeps at most 20 refresh tokens per user per client and 15 live access tokens per refresh token: a 21st authorisation by the same user silently invalidates the oldest connection. Refresh tokens otherwise never expire unless revoked.
Your consumers' other Zoho apps draw on the same daily credit pool as your integration, so a busy organisation can throttle your sync well before its edition's headline limit.
Zoho's Sandbox feature is included only from the Enterprise edition up, so a consumer on a lower edition has no test copy of their org.
- **partnership portal name:** Zoho API console
- **partnership note:** No partner programme and no app review: you register a Server-based client yourself.
- **sandbox url:** https://www.zoho.com/crm/developer/developer-edition.html
- **difficulty:** straightforward
- **partnership required:** false
- **partnership url:** https://api-console.zoho.com/
- **account type required:** Any Zoho CRM edition, including Free
- **apideck credentials available:** true
- **supported resource categories:**   - **name:** Companies & Contacts
  - **resources:** companies
contacts
users
  - **name:** Sales Pipeline
  - **resources:** leads
opportunities
  - **name:** Activities & Notes
  - **resources:** activities
notes
- **difficulty reason:** Self-Service OAuth Client + Free Edition for Testing, No Review or Partnership
- **costs:** None. Registering a Zoho API client is free and API calls draw on the consumer's own edition credits.
- **webhooks:** No webhooks — Zoho CRM changes are not surfaced as Apideck events; sync by polling the CRM and Lead APIs
- **responsibility matrix:**   - **customer:** ✓ (or use Apideck credentials)
  - **area:** Register a Server-based client in the Zoho API console
  - **apideck:** Docs provided
  - **customer:** ✓
  - **area:** Enable Multi-DC for the data centres your consumers use
  - **area:** Add Client ID, Client Secret and scopes in the Apideck Dashboard
  - **customer:** ✓
  - **area:** Authorize the connection in Vault
  - **consumer:** ✓ (user with API Access permission)
  - **apideck:** ✓
  - **area:** Token refresh, credential storage and data-centre routing
  - **area:** Maintain the connector and unified CRM and Lead APIs
  - **apideck:** ✓
- **sandbox available:** true
- **environment notes:**   - **environment:** Testing and production
  - **description:** One Zoho API client serves testing and production. Zoho separates environments at the organisation level: a production org, a Sandbox org (on its own sandbox API domain) and a Developer Edition org are each authorised separately, and a token issued for one organisation cannot call another. Apideck's temporary shared test credentials are an alternative for early evaluation (request access via https://help.apideck.com/en/articles/7774658). Take care when testing against a production org.
- **external guides:**   - **url:** https://www.zoho.com/crm/developer/docs/api/v8/register-client.html
  - **source:** Zoho
  - **title:** Register a client (Zoho API console)
  - **title:** Multi-DC support
  - **url:** https://www.zoho.com/crm/developer/docs/api/v8/multi-dc.html
  - **source:** Zoho
  - **url:** https://www.zoho.com/crm/developer/docs/api/v8/api-limits.html
  - **title:** API limits
  - **source:** Zoho
  - **url:** https://www.zoho.com/crm/developer/docs/api/v8/token-validity.html
  - **source:** Zoho
  - **title:** Token validity
- **rate limits:** Daily credits per org by edition: 5,000 (Free) to 50,000 plus 250 to 2,000 per user (paid); 5 to 25 concurrent calls; HTTP 429 on excess
- **sandbox note:** A Free edition org for your own testing, or a Developer Edition org by invitation from a sandbox-enabled customer.
- **apideck credentials note:** The Zoho consent screen shows "Apideck"; use your own Zoho client in production.

## Supported resources

- **status:** live
- **custom field support:** true
- **name:** Contacts
- **id:** contacts
- **downstream id:** contacts
- **downstream name:** Contacts
- **downstream id:** leads
- **downstream name:** Leads
- **custom field support:** true
- **name:** Leads
- **status:** live
- **id:** leads
- **id:** companies
- **status:** live
- **downstream id:** accounts
- **name:** Companies
- **downstream name:** Accounts
- **custom field support:** true
- **id:** opportunities
- **status:** live
- **name:** Opportunities
- **downstream name:** Deals
- **downstream id:** deals
- **custom field support:** true
- **downstream name:** Activities
- **id:** activities
- **custom field support:** false
- **status:** live
- **name:** Activities
- **downstream id:** activities
- **downstream name:** Notes
- **custom field support:** false
- **id:** notes
- **name:** Notes
- **downstream id:** notes
- **status:** live
- **name:** Users
- **custom field support:** false
- **downstream name:** Users
- **id:** users
- **status:** live
- **downstream id:** users

An omitted operation list does not establish operation support. Verify the selected operation in the coverage matrix.

[API reference](https://developers.apideck.com/apis/crm/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/crm/coverage)