Share via


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
Email 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