> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho Mail

> Zoho Mail is a secure and ad-free email hosting platform with collaboration tools, calendar integration, and extensive administrative controls

![Zoho Mail logo](https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/images/toolkits/zoho_mail.svg?fit=max\&auto=format\&n=11RkPhDhzt1wdr6a\&q=85\&s=ddae7621d8c5f1381a47fe50e67840bd)

* **Category:** email
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 50
* **Triggers:** 0
* **Slug:** `ZOHO_MAIL`
* **Version:** 20261101\_00

## Frequently Asked Questions

> [accordion] What should I pass for the correct Zoho region when connecting Zoho Mail?
>
> For Zoho Mail connection issues, verify the region passed during connection initiation. Zoho accounts can be region-specific, so an EU or other regional account may fail if the default/wrong region is used. Retry the connection with the correct Zoho region.

## Tools

> [accordion] Create Signature
>
> **Slug:** `ZOHO_MAIL_ACCOUNTS_CREATE_SIGNATURE`
>
> Create a signature, optionally assign it to users, and return it.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the signature.
>
> **content** `string` *required*
>
> HTML or plain-text signature content.
>
> **position** `integer` *required*
>
> Place the signature below quoted content (0) or above it (1).
>
> **assign\_users** `string`
>
> Comma-separated email addresses to assign the signature to.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Signatures
>
> **Slug:** `ZOHO_MAIL_ACCOUNTS_GET_SIGNATURES`
>
> List all connected-user signatures or retrieve one signature by ID.
>
> #### Input Parameters
>
> **signature\_id** `string`
>
> Unique signature ID. Omit to list all signatures for the connected user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Zoho Mail Accounts
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> 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`
>
> 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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Account Display Name
>
> **Slug:** `ZOHO_MAIL_ACCOUNTS_UPDATE_DISPLAY_NAME`
>
> Update the display name of a Zoho Mail account owned by the user.
>
> #### Input Parameters
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID. Keep this ID as a string.
>
> **display\_name** `string` *required*
>
> New display name for the Zoho Mail account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Label
>
> **Slug:** `ZOHO_MAIL_DELETE_LABEL`
>
> Delete a label and remove it from associated Zoho Mail messages.
>
> #### Input Parameters
>
> **label\_id** `string` *required*
>
> ID of the label to delete. Keep this ID as a string.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID. Keep this ID as a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Domain Operations
>
> **Slug:** `ZOHO_MAIL_DOMAIN_OPERATIONS`
>
> Administer a Zoho Mail domain: verify DNS, change hosting and aliases, manage DKIM, catch-all, and notification settings. Some modes delete or disable configuration, so treat every call as potentially irreversible.
>
> #### Input Parameters
>
> **mode** `string ("setPrimaryDomain" | "enableMailHosting" | "disableMailHosting" | "verifyDomainByTXT" | "verifyDomainByCName" | "verifyDomainByHTML" | "verifySpfRecord" | "verifyMxRecord" | "makeDomainAsAlias" | "removeDomainAlias" | "addDkimDetail" | "makeDkimDefault" | "deleteDkimDetail" | "regenerateDkimKey" | "verifyDkimKey" | "enableSubDomainStripping" | "disableSubDomainStripping" | "addCatchAllAddress" | "deleteCatchAllAddress" | "addNotificationAddress" | "deleteNotificationAddress")` *required*
>
> Operation to perform on the domain
>
> **dkimId** `string`
>
> DKIM record ID; required for makeDkimDefault, deleteDkimDetail, regenerateDkimKey, and verifyDkimKey operations
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **keySize** `integer ("1024" | "2048")`
>
> Optional DKIM key size (1024 or 2048)
>
> **selector** `string`
>
> DKIM selector; required for addDkimDetail
>
> **isDefault** `boolean`
>
> Make this DKIM record the default; optional for addDkimDetail
>
> **domainName** `string` *required*
>
> Fully qualified domain name to operate on
>
> **domainAlias** `string`
>
> Alias domain name; required for alias operations
>
> **accept\_language** `string`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> **catchAllAddress** `string`
>
> Catch-all address; required for addCatchAllAddress
>
> **organization\_id** `string` *required*
>
> Zoho Mail organization ID
>
> **notificationAddress** `string`
>
> Notification address; required for addNotificationAddress
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Folder
>
> **Slug:** `ZOHO_MAIL_FOLDERS_CREATE_FOLDER`
>
> Create a folder in a Zoho Mail account and return its folder record.
>
> #### Input Parameters
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID. Keep this ID as a string.
>
> **folder\_name** `string` *required*
>
> Unique folder name.
>
> **parent\_folder\_id** `string`
>
> Parent folder ID. Keep this ID as a string.
>
> **parent\_folder\_path** `string`
>
> Parent folder path, such as /Projects.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Folder
>
> **Slug:** `ZOHO_MAIL_FOLDERS_DELETE_FOLDER`
>
> Delete a folder from a Zoho Mail account. The first delete moves the folder to Trash; deleting it again from Trash removes it permanently.
>
> #### Input Parameters
>
> **folder\_id** `string` *required*
>
> ID of the folder to delete, as a string. The first delete moves the folder to Trash; deleting it again from Trash removes it permanently.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID. Keep this ID as a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Folder
>
> **Slug:** `ZOHO_MAIL_FOLDERS_GET_FOLDER`
>
> Retrieve one Zoho Mail folder by account and folder ID.
>
> #### Input Parameters
>
> **folder\_id** `string` *required*
>
> Folder ID. Keep this ID as a string.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID. Keep this ID as a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Folders
>
> **Slug:** `ZOHO_MAIL_FOLDERS_LIST_FOLDERS`
>
> List every folder in a Zoho Mail account. Use the returned folder IDs for message listing, attachment, content, and header operations that require a folder identifier.
>
> #### Input Parameters
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID as a string; obtain it from ZOHO\_MAIL\_ACCOUNTS\_LIST\_ACCOUNTS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Folder
>
> **Slug:** `ZOHO_MAIL_FOLDERS_UPDATE_FOLDER`
>
> Rename or move a Zoho Mail folder, or enable or disable its IMAP visibility, and return its observed state from a follow-up read.
>
> #### Input Parameters
>
> **folder\_id** `string` *required*
>
> Folder ID. Keep this ID as a string.
>
> **operation** `string ("rename" | "move" | "enable_imap" | "disable_imap")` *required*
>
> Folder change to perform: rename, move, enable\_imap, or disable\_imap.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID. Keep this ID as a string.
>
> **folder\_name** `string`
>
> New folder name. Required only when operation is 'rename'.
>
> **parent\_folder\_id** `string`
>
> Destination parent folder ID for 'move'. Omit to move the folder to the root.
>
> **previous\_folder\_id** `string`
>
> Folder after which to position the moved folder. Valid only for 'move'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Groups in Bulk
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **group\_ids** `array` *required*
>
> 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`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> **organization\_id** `string` *required*
>
> 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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Group
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **group\_id** `string` *required*
>
> Zoho Group ID to delete
>
> **accept\_language** `string`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> **organization\_id** `string` *required*
>
> Unique Zoho Organization ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Group
>
> **Slug:** `ZOHO_MAIL_GROUPS_GET_GROUP`
>
> Retrieve one Zoho Mail organization group, including members and settings.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> Unique Zoho group ID returned when the group was created or listed.
>
> **organization\_id** `string` *required*
>
> Unique Zoho organization ID returned by the Organization Details API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Moderated Messages
>
> **Slug:** `ZOHO_MAIL_GROUPS_LIST_MODERATED_MESSAGES`
>
> List messages held for moderation in one Zoho Mail organization group.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum held messages to return in this page (1-50). Omit it to use Zoho's default.
>
> **start** `integer`
>
> Optional result offset. Pass 0 or greater, or omit it to use Zoho's default.
>
> **search** `string`
>
> Optional sender address or subject search text, sent to Zoho as searchKey.
>
> **group\_id** `string` *required*
>
> ID of the organization group whose held messages to list.
>
> **organization\_id** `string` *required*
>
> Zoho Mail organization ID as a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Group Moderation Emails
>
> **Slug:** `ZOHO_MAIL_GROUPS_LIST_MODERATION_EMAILS`
>
> Lists emails held for moderation in a Zoho Mail group, with optional pagination and search. This tool is deprecated.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of moderation emails to return (1-50).
>
> **start** `integer`
>
> Starting index for this page. Zoho defaults to 1 and also documents 0 in its request sample.
>
> **group\_id** `string` *required*
>
> Unique Zoho mail group ID, returned by the Get All Groups API.
>
> **search\_key** `string`
>
> Search criterion matched against sender address or subject.
>
> **organization\_id** `string` *required*
>
> Unique Zoho organization ID, returned by the Organization Details API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Moderate Messages
>
> **Slug:** `ZOHO_MAIL_GROUPS_MODERATE_MESSAGES`
>
> Release held group messages for delivery or permanently reject them.
>
> #### Input Parameters
>
> **decision** `string ("accept" | "reject")` *required*
>
> Decision for every specified held message. Accept releases the message for delivery; reject permanently discards it from moderation.
>
> **group\_id** `string` *required*
>
> ID of the organization group holding the messages.
>
> **message\_ids** `array` *required*
>
> Non-empty list of held message IDs from ZOHO\_MAIL\_GROUPS\_LIST\_MODERATED\_MESSAGES.
>
> **organization\_id** `string` *required*
>
> Zoho Mail organization ID as a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Label
>
> **Slug:** `ZOHO_MAIL_LABELS_CREATE_LABEL`
>
> Create a label in a Zoho Mail account and return its identifiers.
>
> #### Input Parameters
>
> **color** `string`
>
> Label color as exactly six hexadecimal digits prefixed by #.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID. Keep this ID as a string.
>
> **display\_name** `string` *required*
>
> Display name for the new label.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Labels
>
> **Slug:** `ZOHO_MAIL_LABELS_LIST_LABELS`
>
> List every label configured in a Zoho Mail account.
>
> #### Input Parameters
>
> **account\_id** `string` *required*
>
> Zoho Mail account whose labels to list. Keep this ID as a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Bookmarks
>
> **Slug:** `ZOHO_MAIL_LIST_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.
>
> #### Input Parameters
>
> **after** `integer`
>
> Numeric pagination offset. Extract the 'after' query value from the previous response's pagination.next URL.
>
> **limit** `integer`
>
> Number of bookmarks to retrieve. Minimum: 1, Maximum: 399. Defaults to 20.
>
> **fields** `string`
>
> 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" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> 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`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Organization Accounts
>
> **Slug:** `ZOHO_MAIL_LIST_ORGANIZATION_ACCOUNTS`
>
> List one offset-paginated page of accounts managed by a Zoho organization.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of organization accounts to retrieve.
>
> **start** `integer`
>
> Zero-based sequence offset from which to retrieve accounts.
>
> **organization\_id** `string` *required*
>
> Zoho organization ID. Keep this ID as a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Organization Domains
>
> **Slug:** `ZOHO_MAIL_LIST_ORGANIZATION_DOMAINS`
>
> List mail domains configured for a Zoho Mail organization.
>
> #### Input Parameters
>
> **organization\_id** `string` *required*
>
> Zoho organization ID. Keep this ID as a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Manage Domain Addresses
>
> **Slug:** `ZOHO_MAIL_MANAGE_DOMAIN_ADDRESSES`
>
> Add or permanently remove domain aliases, catch-all delivery, and notification addresses.
>
> #### Input Parameters
>
> **operation** `string ("add_alias" | "remove_alias" | "add_catch_all" | "delete_catch_all" | "add_notification" | "delete_notification")` *required*
>
> Add or permanently remove an alias, catch-all address, or notification address.
>
> **domain\_name** `string` *required*
>
> Domain already added to the organization.
>
> **alias\_domain** `string`
>
> Alias domain required for add\_alias and remove\_alias.
>
> **organization\_id** `string` *required*
>
> Zoho Mail organization ID from organization details.
>
> **catch\_all\_address** `string`
>
> Mailbox address required for add\_catch\_all.
>
> **notification\_address** `string`
>
> Mailbox address required for add\_notification.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Manage Domain DKIM
>
> **Slug:** `ZOHO_MAIL_MANAGE_DOMAIN_DKIM`
>
> Add, verify, regenerate, default, or delete a domain DKIM selector.
>
> #### Input Parameters
>
> **dkim\_id** `string`
>
> Existing DKIM ID; required for make\_default, delete, regenerate, and verify.
>
> **key\_size** `integer ("1024" | "2048")`
>
> Optional RSA key size for add.
>
> **selector** `string`
>
> New selector name; required only for add.
>
> **operation** `string ("add" | "make_default" | "delete" | "regenerate" | "verify")` *required*
>
> DKIM lifecycle operation to perform.
>
> **is\_default** `boolean`
>
> Whether a newly added selector should be default.
>
> **domain\_name** `string` *required*
>
> Domain already added to the organization.
>
> **organization\_id** `string` *required*
>
> Zoho Mail organization ID from organization details.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Manage Domain Hosting
>
> **Slug:** `ZOHO_MAIL_MANAGE_DOMAIN_HOSTING`
>
> Set a primary domain or enable/disable mail hosting and subdomain stripping.
>
> #### Input Parameters
>
> **operation** `string ("set_primary" | "enable_mail_hosting" | "disable_mail_hosting" | "enable_subdomain_stripping" | "disable_subdomain_stripping")` *required*
>
> Set the primary domain, enable/disable mail hosting, or enable/disable subdomain stripping.
>
> **domain\_name** `string` *required*
>
> Domain already added to the organization.
>
> **organization\_id** `string` *required*
>
> Zoho Mail organization ID from organization details.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Email Draft
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **content** `string`
>
> Email body content. Format depends on mailFormat parameter.
>
> **subject** `string`
>
> Email subject line.
>
> **encoding** `string`
>
> Character encoding for the email content (UTF-8 is default). Supports Big5, EUC-JP, ISO-8859-1, etc.
>
> **accountId** `string` *required*
>
> Unique Zoho Mail account identifier; obtain via Get All User Accounts API.
>
> **ccAddress** `string`
>
> Carbon copy recipient email address(es). Can be comma-separated.
>
> **toAddress** `string` *required*
>
> Recipient email address(es). Required by Zoho Mail API. Can be comma-separated for multiple recipients.
>
> **askReceipt** `string ("yes" | "no")`
>
> Request read receipt; 'yes' or 'no'.
>
> **bccAddress** `string`
>
> Blind carbon copy recipient email address(es). Can be comma-separated.
>
> **mailFormat** `string ("html" | "plaintext")`
>
> Email content format; 'html' (default) or 'plaintext'.
>
> **fromAddress** `string` *required*
>
> Sender's email address; must be valid and tied to the authenticated account.
>
> **accept\_language** `string`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Email
>
> **Slug:** `ZOHO_MAIL_MESSAGES_DELETE_EMAIL`
>
> Move one Zoho Mail email to trash or permanently delete it.
>
> #### Input Parameters
>
> **expunge** `boolean`
>
> Permanently delete the email when true; when false, move it to trash.
>
> **folder\_id** `string` *required*
>
> Unique identifier of the folder containing the email.
>
> **account\_id** `string` *required*
>
> Unique Zoho Mail account identifier.
>
> **message\_id** `string` *required*
>
> Unique identifier of the email to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Attachment
>
> **Slug:** `ZOHO_MAIL_MESSAGES_DOWNLOAD_ATTACHMENT`
>
> Download one attachment from a Zoho Mail message as a file.
>
> #### Input Parameters
>
> **file\_name** `string`
>
> Optional output filename, preferably attachment\_name from attachment info. If omitted, a safe name is derived from attachment\_id.
>
> **folder\_id** `string` *required*
>
> ID of the folder containing the message attachment.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID as a string; obtain it from ZOHO\_MAIL\_ACCOUNTS\_LIST\_ACCOUNTS.
>
> **message\_id** `string` *required*
>
> ID of the message containing the attachment.
>
> **attachment\_id** `string` *required*
>
> ID of the attachment to download; obtain it from ZOHO\_MAIL\_MESSAGES\_GET\_ATTACHMENT\_INFO.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Attachment Info
>
> **Slug:** `ZOHO_MAIL_MESSAGES_GET_ATTACHMENT_INFO`
>
> Get normal and optional inline attachment metadata for one message.
>
> #### Input Parameters
>
> **folder\_id** `string` *required*
>
> ID of the folder containing the message; obtain it from a folder or message listing.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID as a string; obtain it from ZOHO\_MAIL\_ACCOUNTS\_LIST\_ACCOUNTS.
>
> **message\_id** `string` *required*
>
> ID of the message whose attachment metadata to retrieve.
>
> **include\_inline** `boolean`
>
> Whether to include inline-image metadata and content IDs in addition to normal attachments.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Message Content
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **folder\_id** `string` *required*
>
> Unique folder ID (19-digit string) to identify the folder containing the message (retrievable from Get All Folders API).
>
> **account\_id** `string` *required*
>
> Unique Zoho account ID (19-digit string) to identify the specific account (obtainable via Get User Account Details API).
>
> **message\_id** `string` *required*
>
> Unique message ID (19-digit string) of the email to retrieve content for (available from List Emails API).
>
> **accept\_language** `string`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> **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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Message Headers
>
> **Slug:** `ZOHO_MAIL_MESSAGES_GET_MESSAGE_HEADERS`
>
> Get one email's internet message headers without flattening repeated values.
>
> #### Input Parameters
>
> **raw** `boolean`
>
> True returns RFC-style multiline header text; false returns a mapping of header names to arrays of values.
>
> **folder\_id** `string` *required*
>
> ID of the folder containing the message.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID as a string; obtain it from ZOHO\_MAIL\_ACCOUNTS\_LIST\_ACCOUNTS.
>
> **message\_id** `string` *required*
>
> ID of the message whose internet headers to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Message Metadata
>
> **Slug:** `ZOHO_MAIL_MESSAGES_GET_MESSAGE_METADATA`
>
> Retrieve one email's complete metadata record by account, folder, and message ID.
>
> #### Input Parameters
>
> **folder\_id** `string` *required*
>
> ID of the folder containing the message. Keep this ID as a string.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID. Keep this ID as a string.
>
> **message\_id** `string` *required*
>
> ID of the message whose metadata to retrieve. Keep this ID as a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Emails
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **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" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **status** `string ("read" | "unread" | "all")`
>
> Filter by read status. Options: 'read', 'unread', or 'all'. If omitted, Zoho applies its default.
>
> **flagged** `boolean`
>
> If true, retrieves only flagged/starred emails. Defaults to false.
>
> **sort\_by** `string ("date" | "messageId" | "size")`
>
> Field to sort results by. Options: 'date', 'messageId', 'size'. If not provided, uses API default sorting.
>
> **folder\_id** `string`
>
> 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` *required*
>
> Unique Zoho account ID (19-digit string) to identify the specific account (obtainable via Get User Account Details API).
>
> **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`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> **only\_attachment** `boolean`
>
> If true, retrieves only emails with attachments. Defaults to false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reply to Email
>
> **Slug:** `ZOHO_MAIL_MESSAGES_REPLY_TO_EMAIL`
>
> Send or schedule a reply while preserving the original message thread. Delivery is an irreversible external side effect.
>
> #### Input Parameters
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **content** `string`
>
> Email body content for the reply. Format depends on mailFormat parameter.
>
> **subject** `string`
>
> Email subject line. If not provided, Zoho Mail will use the original subject with 'Re:' prefix.
>
> **encoding** `string`
>
> Character encoding for the email content (UTF-8 is default). Supports Big5, EUC-JP, ISO-8859-1, etc.
>
> **timeZone** `string`
>
> Time zone for scheduled email. Live Zoho calls require it for preset and custom schedules.
>
> **accountId** `string` *required*
>
> Unique Zoho Mail account identifier; obtain via Get All User Accounts API.
>
> **ccAddress** `string`
>
> Carbon copy recipient email address(es). Can be comma-separated.
>
> **messageId** `string` *required*
>
> Unique identifier for the message to reply to; obtain via List Emails API.
>
> **toAddress** `string` *required*
>
> Recipient email address(es). Can be comma-separated for multiple recipients.
>
> **askReceipt** `string ("yes" | "no")`
>
> Request read receipt; 'yes' or 'no'.
>
> **bccAddress** `string`
>
> Blind carbon copy recipient email address(es). Can be comma-separated.
>
> **isSchedule** `boolean`
>
> Enable email scheduling; set to true to schedule the reply for later delivery.
>
> **mailFormat** `string ("html" | "plaintext")`
>
> Email content format; 'html' (default) or 'plaintext'.
>
> **fromAddress** `string` *required*
>
> Sender's email address; must be valid and tied to the authenticated account.
>
> **scheduleTime** `string`
>
> Custom schedule time in format MM/DD/YYYY HH:MM:SS. Required when scheduleType is 6.
>
> **scheduleType** `integer`
>
> Schedule type: 1-5 for preset times, 6 for custom scheduling. Required if isSchedule is true.
>
> **accept\_language** `string`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Email
>
> **Slug:** `ZOHO_MAIL_MESSAGES_SEND_EMAIL`
>
> Send an email immediately or schedule it for later delivery. Delivery is an irreversible external side effect; use only confirmed recipients.
>
> #### Input Parameters
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **content** `string`
>
> Email body content. Format depends on mailFormat parameter.
>
> **subject** `string`
>
> Email subject line.
>
> **encoding** `string`
>
> 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`
>
> Timezone for scheduled delivery. Live Zoho calls require this for preset and custom schedules; use an IANA name such as 'America/Los\_Angeles'.
>
> **accountId** `string` *required*
>
> Unique Zoho Mail account identifier; obtain via Get All User Accounts API.
>
> **ccAddress** `string`
>
> Carbon copy recipient email address(es). Can be comma-separated.
>
> **toAddress** `string` *required*
>
> Recipient email address(es). Can be comma-separated for multiple recipients.
>
> **askReceipt** `string ("yes" | "no")`
>
> Request read receipt; 'yes' or 'no'.
>
> **attachment** `string`
>
> File(s) to attach to the email. The file name will be used as the attachment filename.
>
> **bccAddress** `string`
>
> 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" | "plaintext")`
>
> Email content format; 'html' (default) or 'plaintext'.
>
> **fromAddress** `string` *required*
>
> Sender's email address; must be valid and tied to the authenticated account.
>
> **scheduleTime** `string`
>
> 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`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Emails
>
> **Slug:** `ZOHO_MAIL_MESSAGES_UPDATE_EMAILS`
>
> Updates specified Zoho Mail messages: change read state, move, flag, apply or remove labels, archive or unarchive, or change spam state. This tool is deprecated.
>
> #### Input Parameters
>
> **flag** `string ("info" | "important" | "followup" | "flag_not_set")`
>
> Flag value. Required only when operation is 'set\_flag'.
>
> **folder\_id** `string`
>
> Restrict the update to messages in this folder. Supported for move, flag, label, and spam operations.
>
> **label\_ids** `array`
>
> One or more label IDs. Required only for 'apply\_labels' and 'remove\_labels'.
>
> **operation** `string ("mark_read" | "mark_unread" | "move" | "set_flag" | "apply_labels" | "remove_labels" | "remove_all_labels" | "archive" | "unarchive" | "mark_spam" | "mark_not_spam")` *required*
>
> Update to perform: change read state, move, set a flag, change labels, archive state, or change spam state.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID. Keep this ID as a string to avoid precision loss.
>
> **message\_ids** `array` *required*
>
> One or more Zoho message IDs to update. Keep every ID as a string.
>
> **include\_archived** `boolean`
>
> Whether move, set\_flag, or apply\_labels should include archived messages. Omit to use Zoho's default of false.
>
> **destination\_folder\_id** `string`
>
> Destination folder ID. Required only when operation is 'move'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Messages
>
> **Slug:** `ZOHO_MAIL_MESSAGES_UPDATE_MESSAGES`
>
> Batch-update message or thread read, folder, flag, label, archive, or spam state.
>
> #### Input Parameters
>
> **flag** `string ("info" | "important" | "followup" | "flag_not_set")`
>
> Flag to set or clear. Required only when mode is set\_flag; flag\_not\_set clears the flag.
>
> **mode** `string ("mark_as_read" | "mark_as_unread" | "move" | "set_flag" | "apply_labels" | "remove_labels" | "remove_all_labels" | "archive" | "unarchive" | "move_to_spam" | "mark_not_spam")` *required*
>
> Update to apply: change read state, move, flag, label, archive, or spam state.
>
> **folder\_id** `string`
>
> Folder containing the target messages. Required when is\_folder\_specific is true and otherwise omitted.
>
> **label\_ids** `array`
>
> Non-empty label ID list. Required only when mode is apply\_labels or remove\_labels.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID as a string; obtain it from ZOHO\_MAIL\_ACCOUNTS\_LIST\_ACCOUNTS.
>
> **is\_archive** `boolean`
>
> Archive-context flag accepted only for move, set\_flag, and apply\_labels. Omit it for all other modes.
>
> **thread\_ids** `array`
>
> Non-empty thread ID list for a thread-wide update. Provide exactly one of thread\_ids or message\_ids.
>
> **message\_ids** `array`
>
> Non-empty message ID list to update. Provide exactly one of message\_ids or thread\_ids.
>
> **is\_folder\_specific** `boolean`
>
> Whether the update applies only within one folder. Allowed only for move, set\_flag, apply\_labels, remove\_labels, remove\_all\_labels, move\_to\_spam, and mark\_not\_spam.
>
> **destination\_folder\_id** `string`
>
> Destination folder ID. Required only when mode is move.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Message Attachment
>
> **Slug:** `ZOHO_MAIL_MESSAGES_UPLOAD_ATTACHMENT`
>
> Deprecated: uploads one attachment to a Zoho Mail account without sending an email and returns file-store metadata.
>
> #### Input Parameters
>
> **file\_name** `string`
>
> Filename to send to Zoho. Defaults to the uploaded file's name.
>
> **is\_inline** `boolean`
>
> Whether Zoho should prepare the attachment for inline display in an email body.
>
> **account\_id** `string` *required*
>
> Zoho Mail account identifier; obtain it from the list accounts action.
>
> **attachment** `object` *required*
>
> Single file to upload to Zoho Mail without sending an email.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Attachments
>
> **Slug:** `ZOHO_MAIL_MESSAGES_UPLOAD_ATTACHMENTS`
>
> Deprecated: Upload one or more attachments to a Zoho Mail account for later use in a message, optionally as inline content. Returns temporary attachment metadata; it does not send a message.
>
> #### Input Parameters
>
> **is\_inline** `boolean`
>
> Whether the uploaded files are intended as inline message content rather than normal attachments.
>
> **account\_id** `string` *required*
>
> Zoho Mail account ID as a string; obtain it from ZOHO\_MAIL\_ACCOUNTS\_LIST\_ACCOUNTS.
>
> **attachments** `array` *required*
>
> One or more files to upload. Each file is sent as a repeated attach multipart part using its name and MIME type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization User Storage Details
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **user\_id** `string` *required*
>
> Unique Zoho User ID (path parameter)
>
> **accept\_language** `string`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> **organization\_id** `string` *required*
>
> Unique Zoho Organization ID (path parameter)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Organization Spam Process Type
>
> **Slug:** `ZOHO_MAIL_ORGANIZATION_UPDATE_SPAM_PROCESS_TYPE`
>
> Tool to update organization spam processing type. Use when changing the spam filtering strategy for an organization.
>
> #### Input Parameters
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **accept\_language** `string`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> **organization\_id** `string` *required*
>
> Unique Zoho Organization Identifier (zoid) for the target organization. Obtain this from organization details API or admin console.
>
> **spam\_process\_type** `string ("Off" | "complete" | "content" | "sender" | "sender_header")` *required*
>
> Spam filtering level: Off disables filtering; sender checks sender only; sender\_header checks sender and headers; content scans content; complete applies all checks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update User Storage
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **mode** `string ("updateBaseStorage" | "updateExtraStorage")` *required*
>
> Operation type: 'updateBaseStorage' or 'updateExtraStorage'.
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **user\_id** `string` *required*
>
> Zoho User ID for the user whose storage you want to update. Obtain from list organization users API.
>
> **plan\_type** `string ("newMail5gb" | "newMail10gb" | "mailPremium" | "basic" | "professional")`
>
> Base plan to set; required when mode='updateBaseStorage'.
>
> **addon\_type** `array`
>
> Extra storage add-on(s); required when mode='updateExtraStorage'. Each item must be '\<size>:\<count>' (e.g., '5gb:1', '25gb:2') where size is one of: 5gb, 25gb, 50gb, 100gb, 200gb.
>
> **accept\_language** `string`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> **organization\_id** `string` *required*
>
> Zoho Organization ID. Obtain from Organization Details API or list organization users endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Messages
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **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" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> 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` *required*
>
> Unique Zoho account ID (19-digit string) to identify the specific account (obtainable via Get User Account Details API).
>
> **search\_key** `string` *required*
>
> Search criteria using Zoho Mail search syntax. Examples: 'newMails' (unread messages), 'sender:[sender@example.com](mailto:sender@example.com)' (by sender), 'subject:meeting' (by subject), 'to:[recipient@example.com](mailto:recipient@example.com)' (by recipient), 'has:attachment' (with attachments), and 'has:flags' (flagged messages). Combine criteria with '::'.
>
> **received\_time** `integer`
>
> Unix timestamp in milliseconds; Zoho returns emails received before this time. If omitted, Zoho applies its default time window.
>
> **accept\_language** `string`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Group Task
>
> **Slug:** `ZOHO_MAIL_TASKS_CREATE_GROUP_TASK`
>
> Create a task in a Zoho Mail group.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> Non-empty task title.
>
> **status** `string ("inprogress" | "completed")`
>
> Initial task status.
>
> **subtask** `object`
>
> Nested subtask object. Use the same documented Zoho task body fields and camelCase wire names as the parent task.
>
> **assignee** `string`
>
> Zoho user ID of the member assigned to the task.
>
> **due\_date** `string`
>
> Task due date in DD/MM/YYYY format.
>
> **group\_id** `string` *required*
>
> Zoho group ID in which to create the task. Keep this ID as a string.
>
> **priority** `string ("high" | "medium" | "low")`
>
> Initial task priority.
>
> **recur\_for** `integer`
>
> Positive number of times the task should recur.
>
> **account\_id** `string`
>
> Zoho Mail account identifier linked to the task.
>
> **message\_id** `string`
>
> Unique email message identifier linked to the task.
>
> **project\_id** `string`
>
> Unique project identifier for this group task.
>
> **recur\_from** `string`
>
> Recurrence start date in DD/MM/YYYY format.
>
> **attach\_path** `array`
>
> Uploaded attachment paths.
>
> **description** `string`
>
> Task description.
>
> **recur\_until** `string`
>
> Recurrence end date in DD/MM/YYYY format.
>
> **reminder\_date** `string`
>
> Reminder date and time in ISO 8601 format.
>
> **email\_reminder** `boolean`
>
> Whether to send the task reminder by email.
>
> **parent\_task\_id** `string`
>
> Unique identifier of the parent task.
>
> **popup\_reminder** `boolean`
>
> Whether to show a task reminder notification.
>
> **recurring\_type** `string ("Daily" | "Weekly" | "Monthly" | "Yearly")`
>
> Task recurrence pattern.
>
> **recur\_weekly\_on** `integer`
>
> Weekly recurrence day, from 1 (Sunday) to 7 (Saturday).
>
> **attach\_store\_name** `array`
>
> Uploaded attachment store names.
>
> **recurring\_frequency** `integer`
>
> Positive interval between task recurrences.
>
> **recur\_yearly\_on\_month** `integer`
>
> Yearly recurrence month, from 0 (January) to 11 (December).
>
> **recur\_yearly\_on\_day\_of\_week** `integer`
>
> Yearly recurrence weekday, from 1 (Sunday) to 7 (Saturday).
>
> **recur\_daily\_only\_on\_weekdays** `boolean`
>
> Whether daily recurrence is limited to weekdays.
>
> **recur\_monthly\_on\_day\_of\_week** `integer`
>
> Monthly recurrence weekday, from 1 (Sunday) to 7 (Saturday).
>
> **recur\_yearly\_on\_day\_of\_month** `integer`
>
> Yearly recurrence date, from 1 to 31.
>
> **recur\_monthly\_on\_day\_of\_month** `integer`
>
> Monthly recurrence date, from 1 to 31.
>
> **recur\_yearly\_on\_day\_of\_week\_in\_month** `integer`
>
> Yearly recurrence week number, from 1 to 4.
>
> **recur\_monthly\_on\_day\_of\_week\_in\_month** `integer`
>
> Monthly recurrence week number, from 1 to 4.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Personal Task
>
> **Slug:** `ZOHO_MAIL_TASKS_CREATE_PERSONAL_TASK`
>
> Create a personal task for the connected Zoho Mail user.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> Non-empty task title.
>
> **status** `string ("inprogress" | "completed")`
>
> Task status: inprogress or completed.
>
> **subtask** `object`
>
> Task fields for a subtask to create with this task.
>
> **assignee** `string`
>
> Zoho user ID of the assignee; defaults to the current user.
>
> **due\_date** `string`
>
> Task due date in DD/MM/YYYY format.
>
> **priority** `string ("high" | "medium" | "low")`
>
> Task priority: high, medium, or low.
>
> **recur\_for** `integer`
>
> Positive number of times the task should recur.
>
> **account\_id** `string`
>
> Zoho Mail account identifier linked to the task.
>
> **message\_id** `string`
>
> Unique email message identifier linked to the task.
>
> **project\_id** `string`
>
> Unique project identifier for the task.
>
> **recur\_from** `string`
>
> Recurrence start date in DD/MM/YYYY format.
>
> **attach\_path** `array`
>
> Uploaded attachment paths.
>
> **description** `string`
>
> Non-empty task description.
>
> **recur\_until** `string`
>
> Recurrence end date in DD/MM/YYYY format.
>
> **reminder\_date** `string`
>
> Reminder date and time in ISO 8601 format.
>
> **email\_reminder** `boolean`
>
> Whether to send the task reminder by email.
>
> **parent\_task\_id** `string`
>
> Unique identifier of the parent task.
>
> **popup\_reminder** `boolean`
>
> Whether to send a popup reminder notification.
>
> **recurring\_type** `string ("Daily" | "Weekly" | "Monthly" | "Yearly")`
>
> Task recurrence pattern.
>
> **recur\_weekly\_on** `integer`
>
> Weekly recurrence day, from 1 (Sunday) to 7 (Saturday).
>
> **attach\_store\_name** `array`
>
> Uploaded attachment store names.
>
> **recurring\_frequency** `integer`
>
> Positive number of recurrence intervals between occurrences.
>
> **recur\_yearly\_on\_month** `integer`
>
> Month for yearly recurrence, from 0 (January) to 11 (December).
>
> **recur\_yearly\_on\_day\_of\_week** `integer`
>
> Weekday for yearly recurrence, from 1 (Sunday) to 7 (Saturday).
>
> **recur\_daily\_only\_on\_weekdays** `boolean`
>
> Whether daily recurrence is limited to weekdays.
>
> **recur\_monthly\_on\_day\_of\_week** `integer`
>
> Weekday for monthly recurrence, from 1 (Sunday) to 7 (Saturday).
>
> **recur\_yearly\_on\_day\_of\_month** `integer`
>
> Day of the month for yearly recurrence (1-31).
>
> **recur\_monthly\_on\_day\_of\_month** `integer`
>
> Day of the month for monthly recurrence (1-31).
>
> **recur\_yearly\_on\_day\_of\_week\_in\_month** `integer`
>
> Week number in the month for yearly weekday recurrence (1-4).
>
> **recur\_monthly\_on\_day\_of\_week\_in\_month** `integer`
>
> Week number in the month for monthly weekday recurrence (1-4).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Personal Tasks
>
> **Slug:** `ZOHO_MAIL_TASKS_LIST_PERSONAL_TASKS`
>
> List one offset-paginated page of personal tasks for the connected Zoho Mail user. Use from\_index and limit to retrieve additional pages.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of tasks to retrieve, from 1 through 499.
>
> **status** `string ("inprogress" | "completed")`
>
> Filter tasks by inprogress or completed status.
>
> **from\_index** `integer`
>
> Zero-based task offset sent to Zoho as 'from'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Group Task
>
> **Slug:** `ZOHO_MAIL_TASKS_UPDATE_GROUP_TASK`
>
> Update one documented field on a task in a Zoho Mail group.
>
> #### Input Parameters
>
> **title** `string`
>
> New non-empty task title. Provide exactly one update field.
>
> **status** `string ("inprogress" | "completed")`
>
> New task status. Provide exactly one update field.
>
> **task\_id** `string` *required*
>
> Task ID to update. Keep this ID as a string.
>
> **due\_date** `string`
>
> New task due date in DD/MM/YYYY format.
>
> **group\_id** `string` *required*
>
> Zoho Mail group ID containing the task. Keep this ID as a string.
>
> **priority** `string ("high" | "medium" | "low")`
>
> New task priority. Provide exactly one update field.
>
> **project\_id** `string`
>
> New project ID for the task. Keep this ID as a string.
>
> **assignee\_id** `string`
>
> New assignee ID for the task. Keep this ID as a string.
>
> **description** `string`
>
> New non-empty task description. Provide exactly one update field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Group Settings
>
> **Slug:** `ZOHO_MAIL_UPDATE_GROUP_SETTINGS`
>
> Tool to update group settings. Use after group creation to adjust general or text settings.
>
> #### Input Parameters
>
> **region** `string ("com" | "us" | "eu" | "in" | "com.au" | "au" | "com.cn" | "cn" | "jp" | "ca" | "ae" | "sa" | "uk" | "sg")`
>
> Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'.
>
> **group\_id** `string` *required*
>
> Group ID to update settings for
>
> **text\_settings** `object`
>
> Text settings object for the group
>
> **accept\_language** `string`
>
> Optional Accept-Language header value (e.g., 'en-US', 'en-GB').
>
> **organization\_id** `string` *required*
>
> Zoho Mail organization ID
>
> **general\_settings** `object`
>
> General settings object for the group
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Organization Account
>
> **Slug:** `ZOHO_MAIL_UPDATE_ORGANIZATION_ACCOUNT`
>
> Enable or disable an external account, or update incoming, outgoing, IMAP, POP, or ActiveSync status for an organization-managed mailbox.
>
> #### Input Parameters
>
> **enabled** `boolean`
>
> Whether to enable the selected incoming, outgoing, IMAP, POP, or mobile-sync service. Required for status operations and invalid for external-account enable/disable operations.
>
> **user\_id** `string` *required*
>
> Zoho user ID (zuid) that owns the account. Keep this ID as a string.
>
> **operation** `string ("enable_external_account" | "disable_external_account" | "update_incoming_status" | "update_outgoing_status" | "update_imap_status" | "update_pop_status" | "update_mobile_sync_status")` *required*
>
> Account change to perform. External-account operations enable or disable an added IMAP/POP account; status operations change the selected mailbox access setting.
>
> **account\_id** `string` *required*
>
> Organization mailbox or external IMAP/POP account ID. Keep this ID as a string.
>
> **organization\_id** `string` *required*
>
> Zoho organization ID. Keep this ID as a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Verify Domain Records
>
> **Slug:** `ZOHO_MAIL_VERIFY_DOMAIN_RECORDS`
>
> Verify domain ownership, SPF, or MX DNS records for a Zoho Mail domain.
>
> #### Input Parameters
>
> **domain\_name** `string` *required*
>
> Domain already added to the organization.
>
> **verification** `string ("txt" | "cname" | "html" | "spf" | "mx")` *required*
>
> Record to verify: txt/cname/html prove ownership; spf and mx verify mail DNS.
>
> **organization\_id** `string` *required*
>
> Zoho Mail organization ID from organization details.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
