Zoho Mail
Overview
Pre-built tooling
✅ Authorization
✅ Authorization
✅ Read & write data
✅ Read & write data
Tools | Status |
---|---|
Pre-built integrations | ✅ |
API unification | ✅ |
2-way sync | ✅ |
Webhooks from Nango on data modifications | ✅ |
Real-time webhooks from 3rd-party API | 🚫 (time to contribute: <48h) |
Proxy requests | ✅ |
✅ Observability & data quality
✅ Observability & data quality
Tools | Status |
---|---|
HTTP request logging | ✅ |
End-to-type type safety | ✅ |
Data runtime validation | ✅ |
OpenTelemetry export | ✅ |
Slack alerts on errors | ✅ |
Integration status API | ✅ |
✅ Customization
✅ Customization
Tools | Status |
---|---|
Create or customize use-cases | ✅ |
Pre-configured pagination | ✅ |
Pre-configured rate-limit handling | 🚫 (time to contribute: <48h) |
Per-customer configurations | ✅ |
Pre-built integrations
Others
Others
Endpoint | Description | Readme |
---|---|---|
POST /zoho-mail/send-email | An action to send an email in zoho mail | 🔗 |
POST /zoho-mail/add-user | An action to add a user to the organization in zoho mail | 🔗 |
GET /zoho-mail/tasks | Fetches a list of all your personal tasks in Zoho mail | 🔗 |
GET /zoho-mail/emails | Fetches a list of all your account’s emails in Zoho mail | 🔗 |
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 Mail-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
Mail-specific links
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