Overview

Pre-built tooling

Pre-built integrations

Not seeing the integration you need? Build your own independently.

Access requirements

Pre-RequisitesStatusComment
Paid dev account✅ Not requiredFree Zoho account is sufficient for development.
Paid test account✅ Not requiredFree Zoho account is sufficient for testing.
Partnership✅ Not required
App review✅ Not requiredNo 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 Mail-specific scopes listed in the Common Scopes section below.

Need help getting started? Get help in the community.
Contribute useful links by editing this page

Common Scopes

  • ZohoMail.accounts.READ - Read access to mail accounts
  • ZohoMail.messages.ALL - Access to all mail messages
  • ZohoMail.messages.READ - Read access to mail messages
  • ZohoMail.messages.CREATE - Create mail messages
  • ZohoMail.folders.READ - Read access to mail folders
  • ZohoMail.contacts.READ - Read access to mail contacts

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.

Mail-specific gotchas

  • Zoho Mail API has region-specific endpoints. You need to use the correct endpoint based on the user’s region.
  • According to the documentation for various APIs, OAuth scopes are configured as OAuth Scope + Operation, for example, ZohoMail.messages.READ
Contribute API gotchas by editing this page