# 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](https://toolhouse.app/auth-connections?authkit_slugs=zoho_mail).

## 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  |          | `"<p>Hello, this is a draft message.</p>"` | 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  |     ✅    | `"<p>Thank you for your message. Here is my reply.</p>"` | 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  |     ✅    | `"<p>Hello, this is the email content.</p>"`       | 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                                                        |

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/zoho-mail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.