Zoho Mail

Your Toolhouse AI Worker can connect to Zoho Mail using 15 specialized tools.

Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under Auth Connections.

Tools (15)

`Zoho Mail Accounts List Accounts`

Integration name: ZOHO_MAIL_ACCOUNTS_LIST_ACCOUNTS

Retrieves all Zoho Mail accounts associated with the authenticated user. Returns account details including accountId (required for other mail operations), email addresses, storage information, account status, user preferences, and security settings. Use this action first to get the accountId needed for subsequent mailbox, message, folder, and email operations. The accountId is a unique identifier for each mail account. Typical workflow: List accounts → Get accountId → Use accountId in other mail operations.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

region

string

"com"

Zoho Mail data center region. Determines which regional API endpoint to use (e.g., 'com' → mail.zoho.com, 'eu' → mail.zoho.eu). Choose the region where your Zoho account was created. Options: 'com' (US), 'eu' (Europe), 'in' (India), 'com.au' (Australia), 'jp' (Japan), 'ca' (Canada). If not specified, defaults to 'com' (US).

accept_language

string

"en-US"

Language preference for API responses. Use standard locale codes like 'en-US' for American English or 'en-GB' for British English. This affects error messages and localized content returned by the API.

use_bearer_auth

boolean

—

Internal parameter for authentication handling. Keep as False (default) unless specifically instructed otherwise. When False, automatically converts OAuth tokens to Zoho's required 'Zoho-oauthtoken' format.

`Zoho Mail Domain Operations`

Integration name: ZOHO_MAIL_DOMAIN_OPERATIONS

Tool to perform domain operations like verify, set primary domain, hosting, aliases, MX/SPF checks, DKIM management, and notifications. Use after creating or retrieving a domain.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

mode

string

✅

"setPrimaryDomain"

Operation to perform on the domain

zoid

integer

✅

1234567890

Organization ID (ZOID)

dkimId

integer

98765

DKIM record ID; required for makeDkimDefault, deleteDkimDetail, regenerateDkimKey, and verifyDkimKey operations

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

keySize

integer

1024

DKIM key size (1024 or 2048); required for addDkimDetail

selector

string

"zoho"

DKIM selector; required for addDkimDetail

isDefault

boolean

true

Make this DKIM record the default; optional for addDkimDetail

domainName

string

✅

"example.com"

Fully qualified domain name to operate on

domainAlias

string

"alias.example.com"

Alias domain name; required for alias operations

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

catchAllAddress

string

"catchall@example.com"

Catch-all address; required for addCatchAllAddress

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

notificationAddress

string

"notify@example.com"

Notification address; required for addNotificationAddress

`Zoho Mail Get All Bookmarks`

Integration name: ZOHO_MAIL_GET_ALL_BOOKMARKS

Tool to retrieve all personal bookmarks from a Zoho Mail account. Use when you need to fetch saved bookmarks/links with support for pagination and field filtering.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

after

string

"1"

Specifies the starting point for pagination. Use the value from the 'next' field in previous response pagination to retrieve subsequent pages.

limit

integer

—

Number of bookmarks to retrieve. Minimum: 1, Maximum: 399. Defaults to 20.

fields

string

"title,summary,link"

Comma-separated list specifying bookmark details to retrieve (e.g., 'title,summary,link,linkMetaInfo,collectionName'). If not provided, returns all available details.

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

is_prev

boolean

—

Controls sort order by creation time: true for ascending order, false for descending order. Defaults to descending if not provided.

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Groups Delete Group Bulk`

Integration name: ZOHO_MAIL_GROUPS_DELETE_GROUP_BULK

Delete multiple groups in a single API call. This action permanently removes the specified groups from your Zoho Mail organization. Use this when you need to: - Remove multiple obsolete or unused groups at once - Clean up groups after organizational restructuring - Batch delete groups for administrative purposes Note: Deleted groups cannot be recovered. Ensure you have the correct group IDs before deletion.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

zoid

integer

✅

1234567890123456

Unique Zoho Organization Identifier (zoid) for your organization. You can retrieve this from the GET /api/organization endpoint or from the Zoho Mail admin console.

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

groupList

array

✅

[1111111,2222222,3333333]

Array of zgid values (unique group identifiers) to delete. You can retrieve group IDs using the GET /api/organization/{zoid}/groups endpoint to list all groups.

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Groups Delete Group By Zgid`

Integration name: ZOHO_MAIL_GROUPS_DELETE_GROUP_BY_ZGID

Tool to delete a specific mail group by its zgid. Use when you need to remove a group from your organization after confirming the IDs.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

zgid

integer

✅

9876543210123456

Zoho Group ID to delete

zoid

integer

✅

1234567890123456

Unique Zoho Organization ID

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Messages Create Draft`

Integration name: ZOHO_MAIL_MESSAGES_CREATE_DRAFT

Tool to create and save an email draft in Zoho Mail without sending it. Use when composing emails that need to be saved for later editing or sending.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

mode

string

"draft"

Operation mode; must be 'draft' to save as draft (not send).

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

content

string

"Hello, this is a draft message."

Email body content. Format depends on mailFormat parameter.

subject

string

"Meeting Follow-up"

Email subject line.

encoding

string

"UTF-8"

Character encoding for the email content (UTF-8 is default). Supports Big5, EUC-JP, ISO-8859-1, etc.

accountId

string

✅

"2915211000000008002"

Unique Zoho Mail account identifier; obtain via Get All User Accounts API.

ccAddress

string

"cc@example.com"

Carbon copy recipient email address(es). Can be comma-separated.

toAddress

string

✅

"recipient@example.com"

Recipient email address(es). Required by Zoho Mail API. Can be comma-separated for multiple recipients.

askReceipt

string

"yes"

Request read receipt; 'yes' or 'no'.

bccAddress

string

"bcc@example.com"

Blind carbon copy recipient email address(es). Can be comma-separated.

mailFormat

string

"html"

Email content format; 'html' (default) or 'plaintext'.

fromAddress

string

✅

"sender@example.com"

Sender's email address; must be valid and tied to the authenticated account.

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Messages Get Message Content`

Integration name: ZOHO_MAIL_MESSAGES_GET_MESSAGE_CONTENT

Tool to retrieve the full content/body of a specific Zoho Mail email. Use when you need to fetch the complete email content after listing or searching messages, as list/search endpoints typically return only metadata/summary.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

folder_id

string

✅

"2915211000000002014"

Unique folder ID (19-digit string) to identify the folder containing the message (retrievable from Get All Folders API).

account_id

string

✅

"2915211000000008002"

Unique Zoho account ID (19-digit string) to identify the specific account (obtainable via Get User Account Details API).

message_id

string

✅

"2915211000000456789"

Unique message ID (19-digit string) of the email to retrieve content for (available from List Emails API).

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

include_block_content

boolean

—

If true, includes block quote content with the original email; if false, excludes block content. Useful for threaded/reply block retrieval.

`Zoho Mail Messages List Emails`

Integration name: ZOHO_MAIL_MESSAGES_LIST_EMAILS

Tool to retrieve a list of emails from a Zoho Mail account folder. Use when you need to fetch emails from inbox or specific folder, with support for filtering by read status, attachments, flags, and pagination.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

limit

integer

—

Number of emails to retrieve. Minimum: 1, Maximum: 200. Defaults to 10.

start

integer

—

Starting sequence number of the emails to retrieve for pagination. Defaults to 1.

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

status

string

"read"

Filter by read status. Options: 'read', 'unread'. If not provided, retrieves all emails regardless of read status.

flagged

boolean

—

If true, retrieves only flagged/starred emails. Defaults to false.

sort_by

string

"date"

Field to sort results by. Options: 'date', 'messageId', 'size'. If not provided, uses API default sorting.

folder_id

string

"2915211000000002014"

Unique folder ID (19-digit string) to identify the folder containing the messages (retrievable from Get All Folders API). If not provided, defaults to inbox.

account_id

string

✅

"2915211000000008002"

Unique Zoho account ID (19-digit string) to identify the specific account (obtainable via Get User Account Details API).

search_key

string

"meeting"

Search term to filter emails by subject, sender, or content. Use to find specific emails matching this keyword.

sort_order

boolean

—

Sort order: true for ascending, false for descending. Only applies if sort_by is provided.

threaded_mails

boolean

—

If true, retrieves emails that are part of conversations/threads. Defaults to false.

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

only_attachment

boolean

—

If true, retrieves only emails with attachments. Defaults to false.

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Messages Reply To Email`

Integration name: ZOHO_MAIL_MESSAGES_REPLY_TO_EMAIL

Tool to reply to an existing email via Zoho Mail API. Use when you need to send a reply to a received email message, maintaining email threading.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

content

string

✅

"Thank you for your message. Here is my reply."

Email body content for the reply. Format depends on mailFormat parameter.

subject

string

"Re: Meeting Follow-up"

Email subject line. If not provided, Zoho Mail will use the original subject with 'Re:' prefix.

encoding

string

"UTF-8"

Character encoding for the email content (UTF-8 is default). Supports Big5, EUC-JP, ISO-8859-1, etc.

timeZone

string

"America/New_York"

Time zone for scheduled email. Required when scheduleType is 6.

accountId

string

✅

"2915211000000008002"

Unique Zoho Mail account identifier; obtain via Get All User Accounts API.

ccAddress

string

"cc@example.com"

Carbon copy recipient email address(es). Can be comma-separated.

messageId

string

✅

"123456789012345678"

Unique identifier for the message to reply to; obtain via List Emails API.

toAddress

string

✅

"recipient@example.com"

Recipient email address(es). Can be comma-separated for multiple recipients.

askReceipt

string

"yes"

Request read receipt; 'yes' or 'no'.

bccAddress

string

"bcc@example.com"

Blind carbon copy recipient email address(es). Can be comma-separated.

isSchedule

boolean

true

Enable email scheduling; set to true to schedule the reply for later delivery.

mailFormat

string

"html"

Email content format; 'html' (default) or 'plaintext'.

fromAddress

string

✅

"sender@example.com"

Sender's email address; must be valid and tied to the authenticated account.

scheduleTime

string

"12/31/2026 09:30:00"

Custom schedule time in format MM/DD/YYYY HH:MM:SS. Required when scheduleType is 6.

scheduleType

integer

1

Schedule type: 1-5 for preset times, 6 for custom scheduling. Required if isSchedule is true.

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Messages Send Email`

Integration name: ZOHO_MAIL_MESSAGES_SEND_EMAIL

Tool to send an email via Zoho Mail API. Use when you need to send emails immediately to recipients.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

content

string

✅

"Hello, this is the email content."

Email body content. Format depends on mailFormat parameter.

subject

string

✅

"Meeting Follow-up"

Email subject line.

encoding

string

"UTF-8"

Character encoding for the email content (UTF-8 is default). Supports Big5, EUC-JP, ISO-8859-1, etc.

isInline

boolean

—

Whether attachments should be displayed inline in the email body (useful for images in HTML emails). Default: false (normal attachment).

timeZone

string

"GMT 5:30 (India Standard Time - Asia/Calcutta)"

Timezone for custom schedule (required if scheduleType=6). Example: 'GMT 5:30 (India Standard Time - Asia/Calcutta)'.

accountId

string

✅

"2915211000000008002"

Unique Zoho Mail account identifier; obtain via Get All User Accounts API.

ccAddress

string

"cc@example.com"

Carbon copy recipient email address(es). Can be comma-separated.

toAddress

string

✅

"recipient@example.com"

Recipient email address(es). Can be comma-separated for multiple recipients.

askReceipt

string

"yes"

Request read receipt; 'yes' or 'no'.

attachment

—

File(s) to attach to the email. FileUploadable object(s) where 'name' is the attachment filename.

bccAddress

string

"bcc@example.com"

Blind carbon copy recipient email address(es). Can be comma-separated.

isSchedule

boolean

—

Whether to schedule the email for later sending. Default: false (send immediately).

mailFormat

string

"html"

Email content format; 'html' (default) or 'plaintext'.

fromAddress

string

✅

"sender@example.com"

Sender's email address; must be valid and tied to the authenticated account.

scheduleTime

string

"09/15/2025 14:30:00"

Custom schedule datetime in MM/DD/YYYY HH:MM:SS format (required if scheduleType=6).

scheduleType

integer

—

Scheduling type when isSchedule is true. Values: 1 (1 hour), 2 (2 hours), 3 (4 hours), 4 (next morning), 5 (next afternoon), 6 (custom date/time).

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Organization Get User Storage Details`

Integration name: ZOHO_MAIL_ORGANIZATION_GET_USER_STORAGE_DETAILS

Tool to retrieve storage details for a specific user in the organization. Use when you need to know a user’s total and used storage quotas.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

zoid

integer

✅

123456789

Unique Zoho Organization ID (path parameter)

zuid

integer

✅

987654321

Unique Zoho User ID (path parameter)

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Organization Update Spam Process Type`

Integration name: ZOHO_MAIL_ORGANIZATION_UPDATE_SPAM_PROCESS_TYPE

Tool to update organization spam processing type. Use when changing the spam filtering strategy for an organization.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

mode

string

"updateSpamProcessType"

Operation mode; automatically set to 'updateSpamProcessType'. This field is managed internally.

zoid

integer

✅

123456789

Unique Zoho Organization Identifier (zoid) for the target organization. Obtain this from organization details API or admin console.

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

spamVO

object

✅

—

Spam filtering configuration object containing the desired spam process type setting

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Organization Update User Storage`

Integration name: ZOHO_MAIL_ORGANIZATION_UPDATE_USER_STORAGE

Updates a user's storage allocation within a Zoho Mail organization. Can modify either base storage plan or extra storage add-ons. Use this when you need to: - Change a user's base storage plan (e.g., from basic to mailPremium) - Add or modify extra storage add-ons for a user Prerequisites: You must have valid zoid (organization ID) and zuid (user ID) before calling this action.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

mode

string

✅

—

Operation type: 'updateBaseStorage' or 'updateExtraStorage'.

zoid

integer

✅

12345678

Zoho Organization ID. Obtain from Organization Details API or list organization users endpoint.

zuid

integer

✅

87654321

Zoho User ID for the user whose storage you want to update. Obtain from list organization users API.

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

plan_type

string

—

Base plan to set; required when mode='updateBaseStorage'.

addon_type

array

["5gb:1"]

Extra storage add-on(s); required when mode='updateExtraStorage'. Each item must be ':' (e.g., '5gb:1', '25gb:2') where size is one of: 5gb, 25gb, 50gb, 100gb, 200gb.

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Search Messages`

Integration name: ZOHO_MAIL_SEARCH_MESSAGES

Tool to search emails in a Zoho Mail account using Zoho's searchKey syntax. Use when you need to find specific emails by sender, subject, keywords, status (e.g., unread), attachments, or flags. Returns messageId and folderId needed to fetch full message content.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

limit

integer

—

Number of emails to retrieve per request. Minimum: 1, Maximum: 200. Defaults to 10.

start

integer

—

Starting sequence number for pagination. Defaults to 1.

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

includeto

boolean

—

If true, includes recipient details (To/CC fields) in the response. Defaults to false.

account_id

string

✅

"2915211000000008002"

Unique Zoho account ID (19-digit string) to identify the specific account (obtainable via Get User Account Details API).

search_key

string

✅

"newMails"

Search criteria using Zoho Mail search syntax. Examples: 'newMails' (unread messages), 'from:sender@example.com' (by sender), 'subject:meeting' (by subject), 'to:recipient@example.com' (by recipient), 'hasattachment' (with attachments), 'flagged' (starred messages). Combine multiple criteria with spaces.

received_time

integer

1609459200000

Unix timestamp in milliseconds to filter emails received after this time. If not provided, defaults to emails from 2 minutes prior.

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

`Zoho Mail Update Group Settings`

Integration name: ZOHO_MAIL_UPDATE_GROUP_SETTINGS

Tool to update group settings. Use after group creation to adjust general or text settings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter

Type

Required

Example

Description

mode

string

✅

—

Operation mode, must be 'updateMailGroupOptions'

zgid

integer

✅

—

Group ID to update settings for

zoid

integer

✅

—

Organization ID

region

string

"com"

Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.

accept_language

string

"en-US"

Optional Accept-Language header value (e.g., 'en-US', 'en-GB').

use_bearer_auth

boolean

—

If true, keeps 'Bearer ' Authorization header; otherwise converts to 'Zoho-oauthtoken '.

groupTextSettings

object

—

Text settings object for the group

groupGeneralSettings

object

—

General settings object for the group

PreviousZoho Desk NextZoho Inventory