# Zoho Mail

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

- **Category:** email
- **Auth:** OAUTH2
- **Composio Managed App Available?** Yes
- **Tools:** 15
- **Triggers:** 0
- **Slug:** `ZOHO_MAIL`
- **Version:** 20260309_00

## Tools

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `region` | string | No | 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 | No | 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 | No | 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. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Domain Operations

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("setPrimaryDomain" | "enableMailHosting" | "disableMailHosting" | "verifyDomainByTXT" | "verifyDomainByCName" | "verifyDomainByHTML" | "verifySpfRecord" | "verifyMxRecord" | "makeDomainAsAlias" | "removeDomainAlias" | "addDkimDetail" | "makeDkimDefault" | "deleteDkimDetail" | "regenerateDkimKey" | "verifyDkimKey" | "enableSubDomainStripping" | "disableSubDomainStripping" | "addCatchAllAddress" | "deleteCatchAllAddress" | "addNotificationAddress" | "deleteNotificationAddress") | Yes | Operation to perform on the domain |
| `zoid` | integer | Yes | Organization ID (ZOID) |
| `dkimId` | integer | No | DKIM record ID; required for makeDkimDefault, deleteDkimDetail, regenerateDkimKey, and verifyDkimKey operations |
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `keySize` | integer | No | DKIM key size (1024 or 2048); required for addDkimDetail |
| `selector` | string | No | DKIM selector; required for addDkimDetail |
| `isDefault` | boolean | No | Make this DKIM record the default; optional for addDkimDetail |
| `domainName` | string | Yes | Fully qualified domain name to operate on |
| `domainAlias` | string | No | Alias domain name; required for alias operations |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `catchAllAddress` | string | No | Catch-all address; required for addCatchAllAddress |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |
| `notificationAddress` | string | No | Notification address; required for addNotificationAddress |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get All Bookmarks

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Specifies the starting point for pagination. Use the value from the 'next' field in previous response pagination to retrieve subsequent pages. |
| `limit` | integer | No | Number of bookmarks to retrieve. Minimum: 1, Maximum: 399. Defaults to 20. |
| `fields` | string | No | Comma-separated list specifying bookmark details to retrieve (e.g., 'title,summary,link,linkMetaInfo,collectionName'). If not provided, returns all available details. |
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `is_prev` | boolean | No | Controls sort order by creation time: true for ascending order, false for descending order. Defaults to descending if not provided. |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zoid` | integer | Yes | 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 | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `groupList` | array | Yes | 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 | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zgid` | integer | Yes | Zoho Group ID to delete |
| `zoid` | integer | Yes | Unique Zoho Organization ID |
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string | No | Operation mode; must be 'draft' to save as draft (not send). |
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `content` | string | No | Email body content. Format depends on mailFormat parameter. |
| `subject` | string | No | Email subject line. |
| `encoding` | string | No | Character encoding for the email content (UTF-8 is default). Supports Big5, EUC-JP, ISO-8859-1, etc. |
| `accountId` | string | Yes | Unique Zoho Mail account identifier; obtain via Get All User Accounts API. |
| `ccAddress` | string | No | Carbon copy recipient email address(es). Can be comma-separated. |
| `toAddress` | string | Yes | Recipient email address(es). Required by Zoho Mail API. Can be comma-separated for multiple recipients. |
| `askReceipt` | string ("yes" | "no") | No | Request read receipt; 'yes' or 'no'. |
| `bccAddress` | string | No | Blind carbon copy recipient email address(es). Can be comma-separated. |
| `mailFormat` | string ("html" | "plaintext") | No | Email content format; 'html' (default) or 'plaintext'. |
| `fromAddress` | string | Yes | Sender's email address; must be valid and tied to the authenticated account. |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `folder_id` | integer | Yes | Unique folder ID to identify the folder containing the message (retrievable from Get All Folders API) |
| `account_id` | integer | Yes | Unique Zoho account ID to identify the specific account (obtainable via Get User Account Details API) |
| `message_id` | integer | Yes | Unique message ID of the email to retrieve content for (available from List Emails API) |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |
| `include_block_content` | boolean | No | If true, includes block quote content with the original email; if false, excludes block content. Useful for threaded/reply block retrieval. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of emails to retrieve. Minimum: 1, Maximum: 200. Defaults to 10. |
| `start` | integer | No | Starting sequence number of the emails to retrieve for pagination. Defaults to 1. |
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `status` | string | No | Filter by read status. Options: 'read', 'unread'. If not provided, retrieves all emails regardless of read status. |
| `flagged` | boolean | No | If true, retrieves only flagged/starred emails. Defaults to false. |
| `sort_by` | string | No | Field to sort results by. Options: 'date', 'messageId', 'size'. If not provided, uses API default sorting. |
| `folder_id` | integer | No | Unique folder ID to identify the folder containing the messages (retrievable from Get All Folders API). If not provided, defaults to inbox. |
| `account_id` | integer | Yes | Unique Zoho account ID to identify the specific account (obtainable via Get User Account Details API) |
| `search_key` | string | No | Search term to filter emails by subject, sender, or content. Use to find specific emails matching this keyword. |
| `sort_order` | boolean | No | Sort order: true for ascending, false for descending. Only applies if sort_by is provided. |
| `threaded_mails` | boolean | No | If true, retrieves emails that are part of conversations/threads. Defaults to false. |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `only_attachment` | boolean | No | If true, retrieves only emails with attachments. Defaults to false. |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reply to Email

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `content` | string | Yes | Email body content for the reply. Format depends on mailFormat parameter. |
| `subject` | string | No | Email subject line. If not provided, Zoho Mail will use the original subject with 'Re:' prefix. |
| `encoding` | string | No | Character encoding for the email content (UTF-8 is default). Supports Big5, EUC-JP, ISO-8859-1, etc. |
| `timeZone` | string | No | Time zone for scheduled email. Required when scheduleType is 6. |
| `accountId` | string | Yes | Unique Zoho Mail account identifier; obtain via Get All User Accounts API. |
| `ccAddress` | string | No | Carbon copy recipient email address(es). Can be comma-separated. |
| `messageId` | string | Yes | Unique identifier for the message to reply to; obtain via List Emails API. |
| `toAddress` | string | Yes | Recipient email address(es). Can be comma-separated for multiple recipients. |
| `askReceipt` | string ("yes" | "no") | No | Request read receipt; 'yes' or 'no'. |
| `bccAddress` | string | No | Blind carbon copy recipient email address(es). Can be comma-separated. |
| `isSchedule` | boolean | No | Enable email scheduling; set to true to schedule the reply for later delivery. |
| `mailFormat` | string ("html" | "plaintext") | No | Email content format; 'html' (default) or 'plaintext'. |
| `fromAddress` | string | Yes | Sender's email address; must be valid and tied to the authenticated account. |
| `scheduleTime` | string | No | Custom schedule time in format MM/DD/YYYY HH:MM:SS. Required when scheduleType is 6. |
| `scheduleType` | integer | No | Schedule type: 1-5 for preset times, 6 for custom scheduling. Required if isSchedule is true. |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Email

**Slug:** `ZOHO_MAIL_MESSAGES_SEND_EMAIL`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `content` | string | Yes | Email body content. Format depends on mailFormat parameter. |
| `subject` | string | Yes | Email subject line. |
| `encoding` | string | No | Character encoding for the email content (UTF-8 is default). Supports Big5, EUC-JP, ISO-8859-1, etc. |
| `accountId` | string | Yes | Unique Zoho Mail account identifier; obtain via Get All User Accounts API. |
| `ccAddress` | string | No | Carbon copy recipient email address(es). Can be comma-separated. |
| `toAddress` | string | Yes | Recipient email address(es). Can be comma-separated for multiple recipients. |
| `askReceipt` | string ("yes" | "no") | No | Request read receipt; 'yes' or 'no'. |
| `bccAddress` | string | No | Blind carbon copy recipient email address(es). Can be comma-separated. |
| `mailFormat` | string ("html" | "plaintext") | No | Email content format; 'html' (default) or 'plaintext'. |
| `fromAddress` | string | Yes | Sender's email address; must be valid and tied to the authenticated account. |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zoid` | integer | Yes | Unique Zoho Organization ID (path parameter) |
| `zuid` | integer | Yes | Unique Zoho User ID (path parameter) |
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string | No | Operation mode; automatically set to 'updateSpamProcessType'. This field is managed internally. |
| `zoid` | integer | Yes | Unique Zoho Organization Identifier (zoid) for the target organization. Obtain this from organization details API or admin console. |
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `spamVO` | object | Yes | Spam filtering configuration object containing the desired spam process type setting |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("updateBaseStorage" | "updateExtraStorage") | Yes | Operation type: 'updateBaseStorage' or 'updateExtraStorage'. |
| `zoid` | integer | Yes | Zoho Organization ID. Obtain from Organization Details API or list organization users endpoint. |
| `zuid` | integer | Yes | Zoho User ID for the user whose storage you want to update. Obtain from list organization users API. |
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `planType` | string ("newMail5gb" | "newMail10gb" | "mailPremium" | "basic" | "professional") | No | Base plan to set; required when mode='updateBaseStorage'. |
| `addonType` | array | No | 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 | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of emails to retrieve per request. Minimum: 1, Maximum: 200. Defaults to 10. |
| `start` | integer | No | Starting sequence number for pagination. Defaults to 1. |
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `includeto` | boolean | No | If true, includes recipient details (To/CC fields) in the response. Defaults to false. |
| `account_id` | integer | Yes | Unique Zoho account ID to identify the specific account (obtainable via Get User Account Details API) |
| `search_key` | string | Yes | 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 | No | Unix timestamp in milliseconds to filter emails received after this time. If not provided, defaults to emails from 2 minutes prior. |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string | Yes | Operation mode, must be 'updateMailGroupOptions' |
| `zgid` | integer | Yes | Group ID to update settings for |
| `zoid` | integer | Yes | Organization ID |
| `region` | string | No | Optional Zoho data center domain to target. One of: 'com', 'eu', 'in', 'com.au', 'jp', 'ca'. |
| `accept_language` | string | No | Optional Accept-Language header value (e.g., 'en-US', 'en-GB'). |
| `use_bearer_auth` | boolean | No | If true, keeps 'Bearer <token>' Authorization header; otherwise converts to 'Zoho-oauthtoken <token>'. |
| `groupTextSettings` | object | No | Text settings object for the group |
| `groupGeneralSettings` | object | No | General settings object for the group |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |