Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zoho Mail Messages API

Send, receive, search, and manage email messages and attachments

Zoho Mail Messages API is one of 4 APIs that Zoho Mail publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Messages. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and authentication docs.

This API exposes 14 operations across 13 paths, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against 9 base URLs: https://mail.zoho.com, https://mail.zoho.eu, https://mail.zoho.in, https://mail.zoho.com.au, https://mail.zoho.jp, https://mail.zohocloud.ca, https://mail.zoho.ae, https://mail.zoho.sa, https://mail.zoho.com.cn.

14 operations 13 paths 5 schemas 1 DELETE9 GET3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://mail.zoho.com/api
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

Zoho Mail Messages API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 11 scopes. By default, every request must be authenticated.

Paths & Operations 14

Across 13 paths, the API surfaces 14 operations — 1 DELETE, 9 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Messages 14

Send, receive, search, and manage email messages and attachments

GET
/api/accounts/{accountId}/messages
List emails in folder
listMessages 4 params → 200
POST
/api/accounts/{accountId}/messages
Send an email
sendMessage 1 param body → 200
GET
/api/accounts/{accountId}/messages/search
Search emails
searchMessages 5 params → 200
POST
/api/accounts/{accountId}/messages/attachments
Upload an attachment
uploadAttachment 1 param body → 200
POST
/api/accounts/{accountId}/messages/{messageId}
Reply to email
replyToMessage 2 params body → 200
GET
/api/accounts/{accountId}/messages/view
Get emails in folder by view
viewMessages 4 params → 200
PUT
/api/accounts/{accountId}/updatemessage
Update message(s)
updateMessage 1 param body → 200
DELETE
/api/accounts/{accountId}/folders/{folderId}/messages/{messageId}
Delete email
deleteMessage 3 params → 200
GET
/api/accounts/{accountId}/folders/{folderId}/messages/{messageId}/header
Get email headers
getMessageHeader 3 params → 200
GET
/api/accounts/{accountId}/folders/{folderId}/messages/{messageId}/content
Get email content
getMessageContent 3 params → 200
GET
/api/accounts/{accountId}/folders/{folderId}/messages/{messageId}/details
Get email metadata
getMessageDetails 3 params → 200
GET
/api/accounts/{accountId}/folders/{folderId}/messages/{messageId}/attachmentinfo
Get attachment information
getAttachmentInfo 3 params → 200
GET
/api/accounts/{accountId}/folders/{folderId}/messages/{messageId}/attachments/{attachmentId}
Get attachment content
getAttachmentContent 4 params → 200
GET
/api/accounts/{accountId}/messages/{messageId}/originalmessage
Get original message
getOriginalMessage 2 params → 200

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are Message (9 properties), SendMessageRequest (8 properties), UpdateMessageRequest (4 properties), ApiResponse (2 properties). Each schema is shown below with its type and property counts.

ApiStatus
object
2 properties
ApiResponse
object
2 properties
UpdateMessageRequest
object
4 properties
SendMessageRequest
object
8 properties 3 required
Message
object
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-mail-messages-api-openapi.yml Raw ↑

Other APIs Zoho Mail publishes across the network.

Zoho Mail Accounts API
Zoho Mail Folders API
Zoho Mail Organization API