Zoho Mail
Secure business email for your organization
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Zoho Mail |
| URL | https://www.zoho.com/mail/contact.html?src=mpd-menu |
| zmintegration@zohomail.com |
| Connector Metadata | |
|---|---|
| Publisher | Zoho Corporation |
| Website | https://www.zoho.com/zohomail/ |
| Privacy policy | https://www.zoho.com/privacy.html |
| Categories | Communication |
Zoho Mail is a safe and secure business email solution. The Zoho Mail connector helps you manage your emails and perform actions such as saving them as drafts, receiving them, and triggering flows when new emails arrive. Zoho Mail connector gives you the power to manage your emails and perform actions such as saving them as drafts, receiving them, and triggering flows when new emails arrive.
Publisher: Zoho Corporation
Prerequisites
A verified Zoho Mail account. Click here to create your first account.
How to get credentials
When you create a new connection,
- Select the domain where your Zoho account resides.
- Enter your Zoho Mail credentials.
- Even if the power app is shared with another user, they should create a new connection to start using it.
Zoho Mail API uses OAuth2.0 to authenticate and hence no secondary authentication is required once the account has been set up.
Get started with your connector
Follow the steps below to connect to Zoho Mail :
- Login to your Power Automate account and click Create from the left menu.
- You can choose to create a cloud flow, desktop flow, or business flow. To connect to Zoho Mail, choose the automated cloud flow.
- You can create a flow/template.
- Choose Send mail/Send template mail for your flow/template.
- Enter the desired values for the respective action.
Known Issues and Limitations
- The total email size, including the email headers, body content, inline images, and attachments should not exceed the plan limit.
- Zoho Mail cannot be used for sending out bulk emails and other emails that violates Zoho Mail usage policy. Click here for more details.
Common errors and remedies
To avoid authentication errors, choose the domain where your Zoho Mail account is hosted.
FAQ
https://help.zoho.com/portal/en/kb/mail
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| Select the region where your Zoho account data resides. | string | Select the domain. | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Get account details |
This endpoint gets the account details of the currently authenticated user such as their Account ID and Account display name. Sample prompt as "Get my mail account details" (The plugin would respond with the retrieved Account ID and Account display name). |
| Get email details |
This endpoint gets the email details based on Account ID and message ID such as Message ID, Summary, Email content, Sent on, Sender name, and From. The operation takes the message ID and Account ID as input. Sample prompt "get the email details of message ID 1234 for the account 4567" |
| Get folders |
This endpoint gets details of all folders for the specified user account such as Folder ID and Folder name based on the Account ID. The user enters Account ID as the input. Sample prompt "List all folders for account 1234”, and the operation retrieves all the folders associated with the account 1234. |
| Get labels |
This endpoint gets the details of all labels for the specified user account such as Label ID and Label name based on the Account ID. The user enters Account ID as the input. prompt "Show me all the labels for account 1234”, and the operation retrieves all the labels associated with the account 1234. |
| Get sender list |
Get the list of all email senders |
| Save Draft or Template |
Save the email content either as a draft or as a template |
| Search emails |
This endpoint lists emails for the specified Account ID based on search parameters that display information like the Message ID, Summary, Sent on, Sender name, and From. The user enters keywords by Subject, Email content or sender as the search parameter for the specified account. |
| Send an email |
Send a new email from a specified email address |
Get account details
This endpoint gets the account details of the currently authenticated user such as their Account ID and Account display name. Sample prompt as "Get my mail account details" (The plugin would respond with the retrieved Account ID and Account display name).
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
data
|
data | array of object |
data |
|
Account ID
|
data.accountId | string |
The unique identifier of the account |
|
Account display name
|
data.accountDisplayName | string |
The display name of the account. |
Get email details
This endpoint gets the email details based on Account ID and message ID such as Message ID, Summary, Email content, Sent on, Sender name, and From. The operation takes the message ID and Account ID as input. Sample prompt "get the email details of message ID 1234 for the account 4567"
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Account
|
account_id | True | string |
Choose the user account or specify the account ID |
|
Message ID
|
message_id | True | string |
The unique identifier of the email |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Summary
|
data.summary | string |
Displays email summary in email listing |
|
Sent on
|
data.sentDateInGMT | string |
The email's sent time in GMT |
|
Subject
|
data.subject | string |
the email subject |
|
Message ID
|
data.messageId | string |
The unique identifier of the email |
|
Priority
|
data.priority | string |
The priority set for the email |
|
Has inline
|
data.hasInline | string |
the email has inline |
|
To
|
data.toAddress | string |
comma-separated recipient email addresses |
|
Folder ID
|
data.folderId | string |
The unique identifier of a folder |
|
CC
|
data.ccAddress | string |
comma-separated CC email addresses |
|
Has Attachment
|
data.hasAttachment | string |
email has attachment |
|
Size
|
data.size | string |
The total email size |
|
Sender name
|
data.sender | string |
sender |
|
Received time
|
data.receivedTime | string |
The email's received time |
|
From
|
data.fromAddress | string |
the sender email address |
|
Read status
|
data.status | string |
The read or unread state of the email |
|
Email content
|
data.content | string |
the email content |
Get folders
This endpoint gets details of all folders for the specified user account such as Folder ID and Folder name based on the Account ID. The user enters Account ID as the input. Sample prompt "List all folders for account 1234”, and the operation retrieves all the folders associated with the account 1234.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Account
|
account_id | True | string |
Choose the user account or specify the account ID |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
data
|
data | array of object |
data |
|
Folder name
|
data.folderName | string |
The name of the folder |
|
Folder ID
|
data.folderId | string |
The unique identifier of a folder |
Get labels
This endpoint gets the details of all labels for the specified user account such as Label ID and Label name based on the Account ID. The user enters Account ID as the input. prompt "Show me all the labels for account 1234”, and the operation retrieves all the labels associated with the account 1234.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Account
|
account_id | True | string |
Choose the user account or specify the account ID |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
data
|
data | array of object |
data |
|
Label ID
|
data.labelId | string |
The unique identifier of a Label |
|
Label name
|
data.displayName | string |
The name of the label. |
Get sender list
Get the list of all email senders
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Account
|
account_id | True | string |
Choose the user account or specify the account ID |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
sendMailDetails
|
sendMailDetails | array of object |
sendMailDetails |
|
sendMailId
|
sendMailDetails.sendMailId | string |
sendMailId |
|
displayName
|
sendMailDetails.displayName | string |
displayName |
|
validated
|
sendMailDetails.validated | boolean |
validated |
|
fromAddress
|
sendMailDetails.fromAddress | string |
fromAddress |
|
status
|
sendMailDetails.status | boolean |
status |
Save Draft or Template
Save the email content either as a draft or as a template
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Account
|
account_id | True | string |
Choose the user account or specify the account ID |
|
Save as
|
mode | True | string |
choose type to save either draft or template |
|
From
|
fromAddress | True | string |
Specify the sender email address |
|
To
|
toAddress | True | string |
Specify comma-separated recipient email addresses |
|
CC
|
ccAddress | string |
Specify comma-separated cc email addresses |
|
|
BCC
|
bccAddress | string |
Specify comma-separated bcc email addresses |
|
|
Subject
|
subject | string |
Specify the email subject |
|
|
Email content
|
content | html |
Specify the email content |
|
|
Ask receipt
|
askReceipt | string |
Refers to the email read receipt |
|
|
Mail format
|
mailFormat | string |
Specify the email format |
|
|
content
|
attachmentContent | byte |
Specify the email content |
|
|
name
|
attachmentName | string |
Specify the name of your attachment |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Subject
|
data.subject | string |
the email subject |
|
Message ID
|
data.messageId | string |
The unique identifier of the email |
|
From
|
data.fromAddress | string |
the sender email address |
|
Bcc
|
data.bccAddress | string |
comma-separated bcc email addresses |
|
Mail format
|
data.mailFormat | string |
format of email |
|
To
|
data.toAddress | string |
comma-separated email addresses |
|
Mail body
|
data.content | string |
the email content |
|
CC
|
data.ccAddress | string |
comma-separated cc email addresses |
Search emails
This endpoint lists emails for the specified Account ID based on search parameters that display information like the Message ID, Summary, Sent on, Sender name, and From. The user enters keywords by Subject, Email content or sender as the search parameter for the specified account.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Account
|
account_id | True | string |
Choose the user account or specify the account ID |
|
Start search
|
start | True | integer |
mail search start from |
|
Search limit
|
limit | True | integer |
limit of mail to fetch |
|
Entire email
|
entire | string |
Specify a search term in any part of the email |
|
|
Email content
|
content | string |
Specify a search term in the core email content |
|
|
From
|
sender | string |
Specify a search term or an email address |
|
|
To
|
to | string |
Specify a search term or an email address |
|
|
CC
|
cc | string |
Specify a search term or an email address |
|
|
Subject
|
subject | string |
Specify a search term in the email subject |
|
|
Attachment name
|
fileName | string |
Specify a search term in the attachment name |
|
|
Attachment content
|
fileContent | string |
Specify a search term in the attachment content |
|
|
From date
|
fromDate | date |
Search for emails from the specified date |
|
|
To date
|
toDate | date |
Search for emails until the specified date |
|
|
Group result
|
groupResult | boolean |
Specify if emails of the same conversation should be grouped. |
|
|
Folder
|
in | string |
Choose the folder or specify the folder ID to search for emails. |
|
|
Label
|
label | string |
Choose the label or specify the label ID to search for emails. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Response code
|
status.code | integer |
Response codes for successful and failure API requests. |
|
data
|
data | array of object |
data |
|
Summary
|
data.summary | string |
Displays email summary in email listing |
|
Sent on
|
data.sentDateInGMT | string |
The email's sent time in GMT |
|
Subject
|
data.subject | string |
the email subject |
|
Message ID
|
data.messageId | string |
The unique identifier of the email |
|
Has inline
|
data.hasInline | string |
the email has inline |
|
To
|
data.toAddress | string |
comma-separated recipient email addresses |
|
Folder ID
|
data.folderId | string |
The unique identifier of a folder |
|
CC
|
data.ccAddress | string |
comma-separated CC email addresses |
|
Has Attachment
|
data.hasAttachment | string |
email has attachment |
|
Size
|
data.size | string |
The total email size |
|
Sender name
|
data.sender | string |
Name of the sender. |
|
Received time
|
data.receivedTime | string |
The email's received time |
|
From
|
data.fromAddress | string |
the sender email address |
|
Read status
|
data.status | string |
The read or unread state of the email |
Send an email
Send a new email from a specified email address
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Account
|
account_id | True | string |
Choose the user account or specify the account ID |
|
From
|
fromAddress | True | string |
Specify the sender email address |
|
To
|
toAddress | True | string |
Specify comma-separated recipient email addresses |
|
CC
|
ccAddress | string |
Specify comma-separated cc email addresses |
|
|
BCC
|
bccAddress | string |
Specify comma-separated bcc email addresses |
|
|
Subject
|
subject | string |
Specify the email subject |
|
|
Email content
|
content | html |
Specify the email content |
|
|
Ask receipt
|
askReceipt | string |
Refers to the email read receipt |
|
|
Mail format
|
mailFormat | string |
Specify the email format |
|
|
content
|
attachmentContent | byte |
Content of file |
|
|
name
|
attachmentName | string |
Enter the Attachment Name |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Ask receipt
|
data.askReceipt | string |
Refers to the email read receipt |
|
Subject
|
data.subject | string |
the email subject |
|
Message ID
|
data.messageId | string |
The unique identifier of the email |
|
From
|
data.fromAddress | string |
the sender email address |
|
BCC
|
data.bccAddress | string |
comma-separated bcc email addresses |
|
Mail format
|
data.mailFormat | string |
the email format |
|
To
|
data.toAddress | string |
comma-separated email addresses |
|
Email content
|
data.content | string |
the email content |
|
CC
|
data.ccAddress | string |
comma-separated cc email addresses |
Triggers
| New Mail Notification |
When new mail arrives from sender |
New Mail Notification
When new mail arrives from sender
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Account
|
accId | True | string |
The configured user account |
|
sender
|
criterias | True | string |
Specify the sender email address |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Summary
|
summary | string |
Displays email summary in email listing |
|
Sent on
|
sentDateInGMT | integer |
The email's sent time in GMT |
|
Subject
|
subject | string |
the email subject |
|
Message ID
|
messageId | integer |
The unique identifier of the email |
|
To
|
toAddress | string |
comma-separated recipient email addresses |
|
CC
|
ccAddress | string |
comma-separated cc email addresses |
|
Size
|
size | integer |
the email size |
|
Sender
|
sender | string |
The name of the email sender |
|
Received time
|
receivedTime | integer |
The email's received time |
|
From
|
fromAddress | string |
the sender email address |
|
Body
|
html | string |
the email content |