Connect AI agents to Zoho Mail

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to fetch details for. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it from zohomail_account_list_user first.

This tool takes no inputs.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

modestring

The type of operation to perform. Must be getDKIMFailOption to retrieve the organization's current DKIM fail action.one of getDKIMFailOptiondefault getDKIMFailOption

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

modestring

The type of operation to perform. Must be getDMARCFailOption to retrieve the organization's current DMARC fail action.one of getDMARCFailOptiondefault getDMARCFailOption

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

modestring

The type of operation to perform. Must be getSPFFailOption to retrieve the organization's current SPF fail action.one of getSPFFailOptiondefault getSPFFailOption

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

modestring

The type of operation to perform. Must be getSPFSoftFailOption to retrieve the organization's current SPF soft fail action.one of getSPFSoftFailOptiondefault getSPFSoftFailOption

bookmark_idstringrequired

Numeric ID of the bookmark to look up. This is a Zoho Mail-generated internal identifier, typically a large integer such as 3542000000054321. Obtain it by calling zohomail_bookmark_list for the group first.

group_idstringrequired

Numeric ID of the bookmark group that owns this bookmark. This is a Zoho Mail-generated internal identifier, typically a large integer such as 3542000000012345. Obtain it by calling zohomail_bookmark_list_groups for this connection first.

group_idstringrequired

Unique ID of the bookmark group to operate on. This is a Zoho-generated identifier for a Streams bookmark group, not the group's name. Obtain it by calling zohomail_bookmark_list_groups first, which lists every group's groupId and name.

afterinteger

Position to start retrieving bookmarks from, where 1 is the first bookmark. Used for pagination together with limit — pass the position immediately after the last bookmark returned on the previous page. Omit to start from the first bookmark.

fieldsstring

Comma-separated list of bookmark detail fields to include in the response. Valid values: title, summary, link, linkMetaInfo, collectionName. Omit to return all fields. Example: "title,link,summary".

is_prevboolean

Sort order for the returned bookmarks based on creation time. true returns bookmarks in ascending order (oldest first); false (the default) returns them in descending order (newest first).default false

limitinteger

Maximum number of bookmarks to retrieve in this call, from 1 to 399. Defaults to 20 when omitted.default 20

collection_idstringrequired

Unique ID of the collection scoped to the specified group. Obtain it by calling zohomail_bookmark_list_collections for that group first, which lists every collection's collectionId and collectionName.

group_idstringrequired

Unique ID of the bookmark group to operate on. This is a Zoho-generated identifier for a Streams bookmark group, not the group's name. Obtain it by calling zohomail_bookmark_list_groups first, which lists every group's groupId and name.

afterinteger

Position to start retrieving bookmarks from, where 1 is the first bookmark. Used for pagination together with limit — pass the position immediately after the last bookmark returned on the previous page. Omit to start from the first bookmark.

fieldsstring

Comma-separated list of bookmark detail fields to include in the response. Valid values: title, summary, link, linkMetaInfo, collectionName. Omit to return all fields. Example: "title,link,summary".

is_prevboolean

Sort order for the returned bookmarks based on creation time. true returns bookmarks in ascending order (oldest first); false (the default) returns them in descending order (newest first).default false

limitinteger

Maximum number of bookmarks to retrieve in this call, from 1 to 399. Defaults to 20 when omitted.default 20

group_idstringrequired

Unique ID of the bookmark group to operate on. This is a Zoho-generated identifier for a Streams bookmark group, not the group's name. Obtain it by calling zohomail_bookmark_list_groups first, which lists every group's groupId and name.

This tool takes no inputs.

afterinteger

Position to start retrieving bookmarks from, where 1 is the first bookmark. Used for pagination together with limit — pass the position immediately after the last bookmark returned on the previous page. Omit to start from the first bookmark.

fieldsstring

Comma-separated list of bookmark detail fields to include in the response. Valid values: title, summary, link, linkMetaInfo, collectionName. Omit to return all fields. Example: "title,link,summary".

is_prevboolean

Sort order for the returned bookmarks based on creation time. true returns bookmarks in ascending order (oldest first); false (the default) returns them in descending order (newest first).default false

limitinteger

Maximum number of bookmarks to retrieve in this call, from 1 to 399. Defaults to 20 when omitted.default 20

This tool takes no inputs.

afterinteger

Position to start retrieving bookmarks from, where 1 is the first bookmark. Used for pagination together with limit — pass the position immediately after the last bookmark returned on the previous page. Omit to start from the first bookmark.

fieldsstring

Comma-separated list of bookmark detail fields to include in the response. Valid values: title, summary, link, linkMetaInfo, collectionName. Omit to return all fields. Example: "title,link,summary".

is_prevboolean

Sort order for the returned bookmarks based on creation time. true returns bookmarks in ascending order (oldest first); false (the default) returns them in descending order (newest first).default false

limitinteger

Maximum number of bookmarks to retrieve in this call, from 1 to 399. Defaults to 20 when omitted.default 20

group_idstringrequired

Unique ID of the bookmark group to operate on. This is a Zoho-generated identifier for a Streams bookmark group, not the group's name. Obtain it by calling zohomail_bookmark_list_groups first, which lists every group's groupId and name.

afterinteger

Position to start retrieving bookmarks from, where 1 is the first bookmark. Used for pagination together with limit — pass the position immediately after the last bookmark returned on the previous page. Omit to start from the first bookmark.

fieldsstring

Comma-separated list of bookmark detail fields to include in the response. Valid values: title, summary, link, linkMetaInfo, collectionName. Omit to return all fields. Example: "title,link,summary".

is_prevboolean

Sort order for the returned bookmarks based on creation time. true returns bookmarks in ascending order (oldest first); false (the default) returns them in descending order (newest first).default false

limitinteger

Maximum number of bookmarks to retrieve in this call, from 1 to 399. Defaults to 20 when omitted.default 20

domainNamestringrequired

The name of the domain whose details should be retrieved. Example: zylker.com.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization that owns the domain. Obtain it from Zoho Mail's Get Organization Details endpoint.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization whose domains should be listed. Obtain it from Zoho Mail's Get Organization Details endpoint.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox the folder belongs to. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

folder_idstringrequired

Numeric ID of the folder to fetch. Obtain it from zohomail_folder_list.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to fetch folders from. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling Zoho Mail's Get All Accounts endpoint for this connection first.

zgidstringrequired

Unique identifier (zgid) of the mail group to retrieve. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization that owns the group. This is a Zoho-generated internal identifier, typically a large integer such as 60000000012345. Obtain it by calling zohomail_org_get_organization for this connection first.

messageIdstringrequired

Unique identifier of the held message to fetch. This is a Zoho-generated internal identifier, typically a large integer. Obtain it from zohomail_group_list_emails_held_moderation.

zgidstringrequired

Unique identifier (zgid) of the moderated mail group that holds the message. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization that owns the group. This is a Zoho-generated internal identifier, typically a large integer such as 60000000012345. Obtain it by calling zohomail_org_get_organization for this connection first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization whose groups should be listed. This is a Zoho-generated internal identifier, typically a large integer such as 60000000012345. Obtain it by calling zohomail_org_get_organization for this connection first.

zgidstringrequired

Unique identifier (zgid) of the moderated mail group whose held emails should be listed. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization that owns the group. This is a Zoho-generated internal identifier, typically a large integer such as 60000000012345. Obtain it by calling zohomail_org_get_organization for this connection first.

limitinteger

Maximum number of held emails to return in this call. Zoho caps this at 50. Leave blank to use the API's default page size.

searchKeystring

Free-text search term to filter held emails by sender address or subject. Leave blank to list all held emails.

startinteger

Starting index (1-based) of the held emails to fetch, for paging through a long queue. Defaults to 1 (the first email).default 1

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox the label belongs to. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

label_idstringrequired

Numeric ID of the label to fetch, as returned in the labelId field by zohomail_label_list or zohomail_label_create. Example: 4000000012345.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to fetch labels from. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization whose audit records to retrieve. Obtain it from Zoho Mail's Get Organization Details endpoint (zohomail_org_get_organization).

endTimeinteger

End of the time range to fetch audit records for, as a Unix timestamp in milliseconds. Leave blank to not bound the range by an end time.

lastEntityIdstring

Pagination cursor: the entity identifier to continue after, taken from a previous response. Use together with lastIndexTime to fetch the next page of audit records.

lastIndexTimestring

Pagination cursor: the index timestamp to continue from, taken from a previous response. Use together with lastEntityId to fetch the next page of audit records.

limitinteger

Maximum number of audit records to return, from 1 to 200. Defaults to 10.default 10

searchKeystring

Optional filter that narrows audit records by category, sub-category, operation type, performer, and/or subject, each segment written as '<field>:<code>' and joined with '::' (for example 'category:1002::operationType:16001' for Domain/Add). Segment codes come from Zoho's audit-constants reference (https://www.zoho.com/mail/help/api/get-audit-constants.html), not plain words. Leave blank to return all audit records in the time range.

startTimeinteger

Start of the time range to fetch audit records for, as a Unix timestamp in milliseconds. Leave blank to not bound the range by a start time.

fromTimeintegerrequired

Start of the time range to fetch login history for, as a Unix timestamp in milliseconds. Only the last 90 days of records are available.

modestringrequired

Which category of login activity to retrieve: 'loginActivity' for successful web/app sign-ins, 'failedLoginActivity' for failed sign-in attempts, 'protocolLoginActivity' for successful IMAP/POP/SMTP protocol logins, or 'failedProtocolLoginActivity' for failed protocol logins.one of loginActivityfailedLoginActivityprotocolLoginActivityfailedProtocolLoginActivity

toTimeintegerrequired

End of the time range to fetch login history for, as a Unix timestamp in milliseconds.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization whose login history to retrieve. Obtain it from Zoho Mail's Get Organization Details endpoint (zohomail_org_get_organization).

accessTypestring

Restricts results to a specific access channel: 'web' for browser sign-ins, 'mobile' for the mobile app, or 'all' to include both. Defaults to 'all'.one of allwebmobiledefault all

batchSizeinteger

Number of login records to include in each batch of results, from 1 to 500. Defaults to 10.default 10

scrollIdstring

Pagination cursor returned by a previous call to this endpoint. Provide it to retrieve the next batch of login records after the previous one; leave blank for the first request.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns this message. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

content_idstringrequired

Unique content ID (cid) of the inline image to download, exactly as referenced in the message's HTML body (for example, in an <img src="cid:..."> tag) or in the message's inline-image metadata. Example: "1.5090302392@zohomail".

folder_idstringrequired

Numeric ID of the folder that contains the message whose inline image you want to download. Obtain it by calling zohomail_folder_list for this account first. Example: 6000000023456.

message_idstringrequired

Unique numeric ID of the email message containing the inline image. Obtain it from zohomail_message_list_search_results or another message-listing call. Example: 6000000034567.

file_namestring

Optional file name to associate with the downloaded image, used as a suggested name for the file. If omitted, no specific file name is set. Example: "logo.png".

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns this message. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

attachment_idstringrequired

Unique numeric ID of the specific attachment to download, as returned in the message's attachment metadata (for example, in the message detail response). Example: 6000000045678.

folder_idstringrequired

Numeric ID of the folder that contains the message whose attachment you want to download, such as Inbox, Sent, or a custom folder. Obtain it by calling zohomail_folder_list for this account first. Example: 6000000023456.

message_idstringrequired

Unique numeric ID of the email message the attachment belongs to. Obtain it from zohomail_message_list_search_results or another message-listing call. Example: 6000000034567.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that contains the message. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

folder_idstringrequired

Numeric ID of the folder that contains the message. Obtain it from zohomail_folder_list.

message_idstringrequired

Unique numeric ID of the email to list attachments for. Obtain it from a message-listing tool such as zohomail_message_list_search_results.

include_inlineboolean

Whether to include inline images (e.g. images embedded in the HTML body) alongside regular attachments in the results.default false

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that contains the message. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

folder_idstringrequired

Numeric ID of the folder that contains the message. Obtain it from zohomail_folder_list.

message_idstringrequired

Unique numeric ID of the email to fetch content for. Obtain it from a message-listing tool such as zohomail_message_list_search_results.

include_block_contentboolean

Whether to include quoted block content (earlier messages quoted inline) along with the main email content.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that contains the message. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

folder_idstringrequired

Numeric ID of the folder that contains the message. Obtain it from zohomail_folder_list.

message_idstringrequired

Unique numeric ID of the email to fetch headers for. Obtain it from a message-listing tool such as zohomail_message_list_search_results.

rawboolean

Response format for the headers. true returns raw header text (default); false returns structured JSON.default true

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that contains the message. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

folder_idstringrequired

Numeric ID of the folder that contains the message. Obtain it from zohomail_folder_list.

message_idstringrequired

Unique numeric ID of the email to fetch metadata for. Obtain it from a message-listing tool such as zohomail_message_list_search_results.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that contains the message. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

message_idstringrequired

Unique numeric ID of the email to fetch the original MIME source for. Obtain it from a message-listing tool such as zohomail_message_list_search_results.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to search. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

search_keystringrequired

Search criteria following Zoho Mail's search syntax, e.g. 'subject:invoice' or 'from:customer@example.com'.

include_toboolean

Whether to include each matched email's To-field details in the results.default false

limitinteger

Number of matching emails to return, from 1 to 200. Defaults to 10.default 10

received_timeinteger

Unix timestamp in milliseconds; only emails received before this time are matched. If omitted, Zoho Mail defaults to roughly the current time minus 2 minutes.

startinteger

Starting sequence number of the emails to retrieve, for paginating through results. Defaults to 1.default 1

group_idstringrequired

Unique ID of the Zoho Mail Notes group that owns the note. This is a Zoho-generated internal identifier (a large integer) specific to the Notes API, distinct from a mailbox account ID. Obtain it by calling zohomail_note_list_groups for this connection first.

note_idstringrequired

Unique ID of the note to retrieve. This is a Zoho-generated internal identifier (a large integer). Obtain it by calling zohomail_note_list for this group first.

fieldsstring

Comma-separated list of note detail fields to include in the response. Valid values: title, content, color, bookId, bookName. Omit to return all fields. Example: "title,content,color".

attachment_idstringrequired

Unique ID of the specific attachment to download, as returned in the note's attachment list. Obtain it by calling zohomail_note_list_attachments for this note first.

group_idstringrequired

Unique ID of the Zoho Mail Notes group that owns the note. This is a Zoho-generated internal identifier (a large integer) specific to the Notes API. Obtain it by calling zohomail_note_list_groups for this connection first.

note_idstringrequired

Unique ID of the note that the attachment belongs to. Obtain it by calling zohomail_note_list for this group first.

group_idstringrequired

Unique ID of the notes group whose notes should be listed. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_note_list_groups for this connection first.

afterinteger

Position to start retrieval from, as an integer from 1 to the total number of notes. Omit to start from the beginning.

fieldsstring

Comma-separated list of note details to include in the response, chosen from title, content, color, bookId, bookName. Omit to return all fields.

is_prevboolean

Sort order for retrieval based on created time. true returns notes in ascending order, false (default) returns them in descending order.default false

limitinteger

Number of notes to retrieve, from 1 to 399. Defaults to 25.default 25

group_idstringrequired

Unique ID of the notes group that owns the note. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_note_list_groups for this connection first.

note_idstringrequired

Unique ID of the note whose attachments should be retrieved. This is a Zoho-generated internal identifier, typically a large integer such as 80000000067890. Obtain it by calling zohomail_note_list for this group first.

book_idstringrequired

Unique ID of the notebook whose notes should be retrieved. This is a Zoho-generated internal identifier, typically a large integer such as 90000000078901. Obtain it by calling zohomail_note_list_books for this group first.

group_idstringrequired

Unique ID of the notes group that owns the notebook. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Zoho Mail's documentation labels this path variable 'zgid' on this specific endpoint, though it is the same group ID used elsewhere in the Notes API. Obtain it by calling zohomail_note_list_groups for this connection first.

afterinteger

Position to start retrieval from, as an integer from 1 to the total number of notes. Omit to start from the beginning.

fieldsstring

Comma-separated list of note details to include in the response, chosen from title, content, color, bookId, bookName. Omit to return all fields.

is_prevboolean

Sort order for retrieval based on created time. true returns notes in ascending order, false (default) returns them in descending order.default false

limitinteger

Number of notes to retrieve, from 1 to 399. Defaults to 25.default 25

default_projectbooleanrequired

Whether the response should highlight the group's default notebook. Zoho documents this as a numeric parameter but it takes the boolean values true or false, and is required on this endpoint.

group_idstringrequired

Unique ID of the notes group whose notebooks should be listed. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_note_list_groups for this connection first.

afterinteger

Position to start retrieval from, as an integer from 1 to the total number of notes. Omit to start from the beginning.

fieldsstring

Comma-separated list of note details to include in the response, chosen from title, content, color, bookId, bookName. Omit to return all fields.

is_prevboolean

Sort order for retrieval based on created time. true returns notes in ascending order, false (default) returns them in descending order.default false

limitinteger

Number of notes to retrieve, from 1 to 399. Defaults to 25.default 25

This tool takes no inputs.

afterinteger

Position to start retrieval from, as an integer from 1 to the total number of notes. Omit to start from the beginning.

fieldsstring

Comma-separated list of note details to include in the response, chosen from title, content, color, bookId, bookName. Omit to return all fields.

is_prevboolean

Sort order for retrieval based on created time. true returns notes in ascending order, false (default) returns them in descending order.default false

limitinteger

Number of notes to retrieve, from 1 to 399. Defaults to 25.default 25

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the child organization to fetch. This is a Zoho-generated internal identifier, typically a large integer.

spam_categorystringrequired

The type of spam listing to retrieve, e.g. whiteListEmail, spamEmail, rejectDomain, quarantineIP, spamTLD.one of whiteListEmailspamEmailrejectEmailquarantineEmailtrustedEmailwhiteListDomainspamDomainrejectDomainquarantineDomaintrustedDomainwhiteListIPspamIPrejectIPquarantineIPspamTLDrejectTLDquarantineTLDrecipientSpamEmailrecipientRejectEmailrecipientQuarantineEmail

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

limitinteger

Number of spam-listing entries to retrieve in this batch. Maximum value is 500.

modestring

The mode of action performed by the API. Must be getMarkingData for this read operation.one of getMarkingDatadefault getMarkingData

startinteger

Order number from which data retrieval should start. Works best together with limit.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

limitinteger

Number of users to retrieve details for in this batch. Used together with start for pagination.

startinteger

Order number from which data retrieval should start. Used together with limit for pagination.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

zuidstringrequired

Unique Zoho User Identifier (zuid) for the user whose storage details to fetch. Obtain it from Zoho Mail's User Account Details endpoint.

policy_idstringrequired

Unique identifier of the mail policy whose assigned groups to list. Obtain it by calling zohomail_policy_list_policies for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization. Obtain it by calling zohomail_org_get_organization for this connection first.

limitinteger

Maximum number of groups to return in this page, counted from start. Defaults to 10.default 10

search_keystring

Optional text to search for among the policy's assigned groups, matched against fields such as the group name.

startinteger

Zero-based start sequence number for the page of groups to return. Defaults to 0.default 0

policy_idstringrequired

Unique identifier of the mail policy whose assigned users to list. Obtain it by calling zohomail_policy_list_policies for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization. Obtain it by calling zohomail_org_get_organization for this connection first.

limitinteger

Maximum number of users to return in this page, counted from start. Defaults to 10.default 10

search_keystring

Optional text to search for among the policy's assigned users, matched against fields such as name or email address.

startinteger

Zero-based start sequence number for the page of users to return. Defaults to 0.default 0

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization whose access restrictions are being listed. This is a Zoho-generated numeric ID, not the organization's domain or display name. Obtain it by calling zohomail_org_get_organization for this connection first.

limitinteger

Maximum number of restrictions to return in this page, counted from start. Defaults to 10.default 10

search_keystring

Free-text term to filter access restrictions by, matched against restriction attributes such as the restriction name. Leave blank to return all restrictions.

startinteger

Zero-based sequence number of the first restriction to return, for paginating through the results. Defaults to 0 (the beginning of the list). Increase by the page size (see limit) to fetch subsequent pages.default 0

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization whose account restrictions are being listed. This is a Zoho-generated numeric ID, not the organization's domain or display name. Obtain it by calling zohomail_org_get_organization for this connection first.

limitinteger

Maximum number of restrictions to return in this page, counted from start. Defaults to 10.default 10

search_keystring

Free-text term to filter account restrictions by, matched against restriction attributes such as the restriction name. Leave blank to return all restrictions.

startinteger

Zero-based sequence number of the first restriction to return, for paginating through the results. Defaults to 0 (the beginning of the list). Increase by the page size (see limit) to fetch subsequent pages.default 0

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization whose email restrictions are being listed. This is a Zoho-generated numeric ID, not the organization's domain or display name. Obtain it by calling zohomail_org_get_organization for this connection first.

limitinteger

Maximum number of restrictions to return in this page, counted from start. Defaults to 10.default 10

search_keystring

Free-text term to filter email restrictions by, matched against restriction attributes such as the restriction name. Leave blank to return all restrictions.

startinteger

Zero-based sequence number of the first restriction to return, for paginating through the results. Defaults to 0 (the beginning of the list). Increase by the page size (see limit) to fetch subsequent pages.default 0

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization whose forward restrictions are being listed. This is a Zoho-generated numeric ID, not the organization's domain or display name. Obtain it by calling zohomail_org_get_organization for this connection first.

limitinteger

Maximum number of restrictions to return in this page, counted from start. Defaults to 10.default 10

search_keystring

Free-text term to filter forward restrictions by, matched against restriction attributes such as the restriction name. Leave blank to return all restrictions.

startinteger

Zero-based sequence number of the first restriction to return, for paginating through the results. Defaults to 0 (the beginning of the list). Increase by the page size (see limit) to fetch subsequent pages.default 0

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization whose policies are being listed. This is a Zoho-generated numeric ID, not the organization's domain or display name. Obtain it by calling zohomail_org_get_organization for this connection first.

limitinteger

Maximum number of policies to return in this page, counted from start. Defaults to 50.default 50

search_keystring

Free-text term to filter policies by, matched against policy attributes such as the policy name. Leave blank to return all policies.

startinteger

Zero-based sequence number of the first policy to return, for paginating through the results. Defaults to 0 (the beginning of the list). Increase by the page size (see limit) to fetch subsequent pages.default 0

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization that owns the target user. This is a Zoho-generated numeric ID, distinct from any domain or email address, typically a large integer such as 60012345678. Obtain it by calling zohomail_org_get_organization for this connection first.

zuidstringrequired

Unique Zoho User Identifier (zuid) for the user whose signatures to fetch. Obtain it by calling zohomail_user_list_org for this organization first.

idstring

Unique key identifying a single signature to retrieve. Optional — omit to return all signatures configured on this account. Example: "6000000012345".

zgidstringrequired

Unique identifier (zgid) of the Zoho Mail task group whose custom statuses should be listed. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_task_list_groups first.

taskIdstringrequired

Unique identifier of the task to retrieve. This tool is for a task that belongs to a group. Obtain it from a task-listing tool such as zohomail_task_list_group, zohomail_task_list_personal, zohomail_task_list_assigned_you, or zohomail_task_list_created_you.

zgidstringrequired

Unique identifier (zgid) of the mail group that owns this task, project, or custom status. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

zgidstringrequired

Unique identifier (zgid) of the Zoho Mail task group whose members should be listed. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_task_list_groups first.

taskIdstringrequired

Unique identifier of the task to retrieve. This tool is for one of your own personal tasks. Obtain it from a task-listing tool such as zohomail_task_list_group, zohomail_task_list_personal, zohomail_task_list_assigned_you, or zohomail_task_list_created_you.

frominteger

Zero-based offset of the first task to return, used to page through results. Defaults to 0 (start from the first task).default 0

limitinteger

Maximum number of tasks to return in this page of results. Accepts values from 1 to 499. Defaults to 20 if omitted.default 20

frominteger

Zero-based offset of the first task to return, used to page through results. Defaults to 0 (start from the first task).default 0

limitinteger

Maximum number of tasks to return in this page of results. Accepts values from 1 to 499. Defaults to 20 if omitted.default 20

zgidstringrequired

Unique identifier (zgid) of the mail group that owns this task, project, or custom status. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

frominteger

Zero-based offset of the first task to return, used to page through results. Defaults to 0 (start from the first task).default 0

limitinteger

Maximum number of tasks to return in this page of results. Accepts values from 1 to 499. Defaults to 20 if omitted.default 20

statusstringrequired

Required filter for the completion status of tasks to return. Valid values: inprogress, completed.one of inprogresscompleted

zgidstringrequired

Unique identifier (zgid) of the Zoho Mail task group whose tasks should be listed. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_task_list_groups first.

frominteger

Zero-based task number to start retrieval from. Range: 0 to the total number of available tasks. Defaults to 0.default 0

limitinteger

Maximum number of tasks to return in this page, counted from the position given by 'from'. Range: 1-499. Defaults to 20.default 20

This tool takes no inputs.

frominteger

Zero-based offset of the first task to return, used to page through results. Defaults to 0 (start from the first task).default 0

limitinteger

Maximum number of tasks to return in this page of results. Accepts values from 1 to 499. Defaults to 20 if omitted.default 20

projectIdstringrequired

Unique identifier of the project whose tasks should be listed. Obtain it by calling zohomail_task_list_projects_group first.

zgidstringrequired

Unique identifier (zgid) of the mail group that owns this task, project, or custom status. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

frominteger

Zero-based offset of the first task to return, used to page through results. Defaults to 0 (start from the first task).default 0

limitinteger

Maximum number of tasks to return in this page of results. Accepts values from 1 to 499. Defaults to 20 if omitted.default 20

project_idstringrequired

Unique identifier of the task project within the group whose tasks should be listed. This is a Zoho-generated internal identifier, typically a large integer such as 80000000098765.

zgidstringrequired

Unique identifier (zgid) of the Zoho Mail task group that owns the project. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_task_list_groups first.

frominteger

Zero-based task number to start retrieval from. Range: 0 to the total number of available tasks. Defaults to 0.default 0

limitinteger

Maximum number of tasks to return in this page, counted from the position given by 'from'. Range: 1-499. Defaults to 20.default 20

statusstring

Optional filter for the completion status of tasks to return. Valid values: inprogress, completed. Omit to return tasks in any status.one of inprogresscompleted

zgidstringrequired

Unique identifier (zgid) of the mail group that owns this task, project, or custom status. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

taskIdstringrequired

Unique identifier of the task to retrieve. This tool lists subtasks under a group task. Obtain it from a task-listing tool such as zohomail_task_list_group, zohomail_task_list_personal, zohomail_task_list_assigned_you, or zohomail_task_list_created_you.

zgidstringrequired

Unique identifier (zgid) of the mail group that owns this task, project, or custom status. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

taskIdstringrequired

Unique identifier of the task to retrieve. This tool lists subtasks under one of your own personal tasks. Obtain it from a task-listing tool such as zohomail_task_list_group, zohomail_task_list_personal, zohomail_task_list_assigned_you, or zohomail_task_list_created_you.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization that owns this user account. This is a Zoho-generated numeric ID, distinct from any domain or email address, typically a large integer such as 60012345678. Obtain it by calling zohomail_org_get_organization for this connection first.

zuidstringrequired

Identifier of the user to fetch — either the unique Zoho user identifier (zuid), or the user's full email address; either value works in this same field. Obtain the zuid by calling zohomail_user_list_org for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization whose users to list. This is a Zoho-generated numeric ID, distinct from any domain or email address, typically a large integer such as 60012345678. Obtain it by calling zohomail_org_get_organization for this connection first.

limitinteger

Number of user accounts to retrieve starting from the start offset. Defaults to 10.default 10

startinteger

Starting sequence number from which user account data retrieval should begin, for pagination. Defaults to 0 (the first record).default 0

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to add email forwarding to. This is a Zoho-generated internal identifier, not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it from zohomail_account_list_user first.

forward_to_addressesarrayrequired

One or more email addresses that incoming mail for this account should be forwarded to. Example: ["assistant@example.com", "archive@example.com"].

is_user_forwardboolean

Whether this forwarding rule is being set up by the account's own user (true) rather than by an administrator acting on the user's behalf (false). Optional; if omitted, Zoho uses its own default.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to add send-mail configuration to. This is a Zoho-generated internal identifier, not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it from zohomail_account_list_user first.

send_mail_detailsarrayrequired

One or more send-mail configurations to add to this account. Each entry needs a display name and a connection mode: 'extmailbox' routes mail through a custom outgoing SMTP server (also provide the server host, port, username, password, and connection security), while 'extfrom' just registers an extra from-address the account can send as. Example: [{"display_name": "Support Team", "connection_mode": "extmailbox", "from_address": "support@example.com", "server_name": "smtp.example.com", "server_port": "587", "user_name": "smtpuser", "password": "smtp-password", "smtp_connection": "TLS"}]

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to act on. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

from_datestringrequired

Start of the vacation period during which the auto-reply is active, in the format MM/DD/YYYY HH:MM:SS, e.g. 01/15/2026 00:00:00.

sending_intintegerrequired

Minimum number of days Zoho Mail waits before sending another auto-reply to the same sender, so repeat senders are not auto-replied to on every message they send.

to_datestringrequired

End of the vacation period during which the auto-reply is active, in the format MM/DD/YYYY HH:MM:SS, e.g. 01/22/2026 23:59:59.

contentstring

Body text of the vacation auto-reply email, sent to anyone who emails this account while the vacation period is active.

for_all_acctsboolean

Whether this vacation auto-reply should apply to all mail accounts under this user, not just the one identified by account_id.

namestring

A short internal name for this vacation auto-reply configuration, shown in the Zoho Mail settings UI. It is not shown to people receiving the auto-reply.

reply_for_all_mailsboolean

Whether the vacation auto-reply should be sent for every incoming message, regardless of which of the account's addresses it was sent to.

reply_for_to_mailsboolean

Whether the vacation auto-reply should only be sent when this account's own address appears directly in the message's To field, rather than only on Cc or a mailing list.

send_tostring

Which senders should receive the vacation auto-reply. One of: all (everyone), contacts (only saved contacts), noncontacts (only senders not in your contacts), org (only people in your organization), nonOrgAll (only people outside your organization), nonOrgContacts (only external contacts), or nonOrgNonContacts (only external non-contacts). Defaults to Zoho Mail's own setting when left blank.one of allcontactsnoncontactsorgnonOrgAllnonOrgContactsnonOrgNonContacts

subjectstring

Subject line of the vacation auto-reply email.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to act on. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

delete_copyboolean

Whether Zoho Mail should also delete its own local copy of a message after forwarding it to another address. Defaults to true (Zoho Mail's own default) when left blank, meaning no local copy is kept.default true

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to act on. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

mail_forward_tostringrequired

Email address whose forwarding should be paused. Must match an address already configured for forwarding on this account.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to act on. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

mail_forward_tostringrequired

Email address that incoming mail on this Zoho Mail account should be forwarded to. Zoho Mail may require this address to be verified before forwarding actually takes effect.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to act on. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

mail_forward_tostringrequired

Email address whose pending forwarding verification email should be resent. Must be an address that was already added for forwarding but not yet confirmed.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox whose pending reply-to address needs its verification email resent. This is a Zoho-generated internal identifier, not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it from zohomail_account_list_user first.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox whose display name is being updated. This is a Zoho-generated internal identifier, not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it from zohomail_account_list_user first.

display_namestringrequired

New display name to show as the sender name on mail sent from this account, e.g. "Jane Smith" or "Support Team".

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox being updated. This is a Zoho-generated internal identifier, not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it from zohomail_account_list_user first.

display_namestringrequired

New display name to show as the sender name on mail sent from this account, e.g. "Jane Smith" or "Support Team".

email_addressstringrequired

New email address to set for this account, e.g. "jane.smith@example.com". Must be a valid, deliverable address on a domain the organization controls.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox whose email address is being updated. This is a Zoho-generated internal identifier, not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it from zohomail_account_list_user first.

email_addressstringrequired

New email address to set for this account, e.g. "jane.smith@example.com". Must be a valid, deliverable address on a domain the organization controls.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox whose account list ordering is being updated. This is a Zoho-generated internal identifier, not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it from zohomail_account_list_user first.

account_orderstringrequired

Comma-separated list of numeric Zoho Mail account IDs, listed in the order they should be displayed. Every account ID the user has must be included, not just the ones being moved. Example: "6000000012345,6000000067890,6000000054321".

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox whose reply-to address is being updated. This is a Zoho-generated internal identifier, not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it from zohomail_account_list_user first.

reply_tostringrequired

New email address to set as the reply-to address for this account. Replies to mail sent from this account will go here instead of the sending address. Must be a valid email address, e.g. "support@example.com". Zoho sends a verification email to this address before it becomes active.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to act on. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

from_datestringrequired

Start of the vacation period during which the auto-reply is active, in the format MM/DD/YYYY HH:MM:SS, e.g. 01/15/2026 00:00:00.

sending_intintegerrequired

Minimum number of days Zoho Mail waits before sending another auto-reply to the same sender, so repeat senders are not auto-replied to on every message they send.

to_datestringrequired

End of the vacation period during which the auto-reply is active, in the format MM/DD/YYYY HH:MM:SS, e.g. 01/22/2026 23:59:59.

contentstring

Body text of the vacation auto-reply email, sent to anyone who emails this account while the vacation period is active.

for_all_acctsboolean

Whether this vacation auto-reply should apply to all mail accounts under this user, not just the one identified by account_id.

namestring

A short internal name for this vacation auto-reply configuration, shown in the Zoho Mail settings UI. It is not shown to people receiving the auto-reply.

reply_for_all_mailsboolean

Whether the vacation auto-reply should be sent for every incoming message, regardless of which of the account's addresses it was sent to.

reply_for_to_mailsboolean

Whether the vacation auto-reply should only be sent when this account's own address appears directly in the message's To field, rather than only on Cc or a mailing list.

send_tostring

Which senders should receive the vacation auto-reply. One of: all (everyone), contacts (only saved contacts), noncontacts (only senders not in your contacts), org (only people in your organization), nonOrgAll (only people outside your organization), nonOrgContacts (only external contacts), or nonOrgNonContacts (only external non-contacts). Defaults to Zoho Mail's own setting when left blank.one of allcontactsnoncontactsorgnonOrgAllnonOrgContactsnonOrgNonContacts

subjectstring

Subject line of the vacation auto-reply email.

vacation_idstring

Unique identifier of the existing vacation auto-reply to update. If omitted, Zoho Mail updates the account's current active vacation reply configuration.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to act on. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

confirm_keystringrequired

Confirmation key Zoho Mail sent to the forwarding address in its verification email. Copy it from that email (or from the confirmation link's query parameter) and pass it here to prove you control the forwarding address.

mail_forward_tostringrequired

Email address that incoming mail is being forwarded to, whose forwarding configuration you are confirming. Must match the address the verification email was sent to.

optionstringrequired

The action to take when an email fails DKIM verification. One of moveToQuarantine (quarantine the email), permanentReject (bounce it permanently), temporaryReject (bounce it temporarily so a legitimate sender's retry can succeed), or allowMail (deliver it anyway).one of moveToQuarantinepermanentRejecttemporaryRejectallowMail

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

optionstringrequired

The action to take when an email fails DMARC. One of moveToQuarantine (quarantine the email), moveToSpam (deliver it to the recipient's spam folder), or allowMail (deliver it normally).one of moveToQuarantinemoveToSpamallowMail

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

optionstringrequired

The action to take when an email fails the SPF check. One of moveToQuarantine (quarantine the email), permanentReject (bounce it permanently), temporaryReject (bounce it temporarily so a legitimate sender's retry can succeed), or allowMail (deliver it anyway).one of moveToQuarantinepermanentRejecttemporaryRejectallowMail

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

optionstringrequired

The action to take when an email fails the SPF soft check. One of moveToQuarantine (quarantine the email), permanentReject (bounce it permanently), temporaryReject (bounce it temporarily so a legitimate sender's retry can succeed), or allowMail (deliver it anyway).one of moveToQuarantinepermanentRejecttemporaryRejectallowMail

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

group_idstringrequired

Unique ID of the bookmark group to operate on. This is a Zoho-generated identifier for a Streams bookmark group, not the group's name. Obtain it by calling zohomail_bookmark_list_groups first, which lists every group's groupId and name.

linkstringrequired

URL to save as a bookmark. Must be a valid, absolute URL including the scheme, e.g. "https://www.zoho.com".

titlestringrequired

Title to display for this bookmark.

collection_idstring

Unique ID of the collection scoped to the specified group. Obtain it by calling zohomail_bookmark_list_collections for that group first, which lists every collection's collectionId and collectionName. Omit to add the bookmark to the group without filing it into a collection.

summarystring

Optional summary or note describing this bookmark.

collection_namestringrequired

Name for the new bookmark collection.

group_idstringrequired

Unique ID of the bookmark group to operate on. This is a Zoho-generated identifier for a Streams bookmark group, not the group's name. Obtain it by calling zohomail_bookmark_list_groups first, which lists every group's groupId and name.

bookmark_idstringrequired

Numeric ID of the bookmark to update. This is a Zoho Mail-generated internal identifier, typically a large integer such as 3542000000054321. Obtain it by calling zohomail_bookmark_list for the group first.

group_idstringrequired

Numeric ID of the bookmark group that owns this bookmark. This is a Zoho Mail-generated internal identifier, typically a large integer such as 3542000000012345. Obtain it by calling zohomail_bookmark_list_groups for this connection first.

linkstringrequired

The updated URL for the bookmark. Must be the full link the bookmark should point to, e.g. https://example.com/docs. This replaces the bookmark's existing link entirely.

titlestringrequired

The updated title for the bookmark. This replaces the bookmark's existing title entirely.

collection_idstring

Numeric ID of the collection to move this bookmark into, obtained from zohomail_bookmark_list_collections. Leave unset to leave the bookmark's current collection unchanged.

summarystring

The updated summary or description text for the bookmark. Leave unset to leave the existing summary unchanged.

collection_idstringrequired

Numeric ID of the collection to rename. This is a Zoho Mail-generated internal identifier, typically a large integer such as 3542000000067890. Obtain it by calling zohomail_bookmark_list_collections for the group first.

collection_namestringrequired

The updated name for the collection. Replaces the collection's existing name entirely.

group_idstringrequired

Numeric ID of the bookmark group that owns this collection. This is a Zoho Mail-generated internal identifier, typically a large integer such as 3542000000012345. Obtain it by calling zohomail_bookmark_list_groups for this connection first.

bookmark_idstringrequired

Numeric ID of the bookmark to mark as favorite. This is a Zoho Mail-generated internal identifier, typically a large integer such as 3542000000054321. Obtain it by calling zohomail_bookmark_list for the group first.

group_idstringrequired

Numeric ID of the bookmark group that owns this bookmark. This is a Zoho Mail-generated internal identifier, typically a large integer such as 3542000000012345. Obtain it by calling zohomail_bookmark_list_groups for this connection first.

bookmark_idstringrequired

Numeric ID of the bookmark to restore. This is a Zoho Mail-generated internal identifier, typically a large integer such as 3542000000054321. Obtain it by calling zohomail_bookmark_list for the group first.

group_idstringrequired

Numeric ID of the bookmark group that owns this bookmark. This is a Zoho Mail-generated internal identifier, typically a large integer such as 3542000000012345. Obtain it by calling zohomail_bookmark_list_groups for this connection first.

domainAliasstringrequired

The name of the domain to add as an alias of domainName. Example: zylker.org.

domainNamestringrequired

The name of the domain that domainAlias should point to. Example: zylker.com.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization that owns the domain. Obtain it from Zoho Mail's Get Organization Details endpoint.

catchAllAddressstringrequired

The email address that should receive mail sent to any non-existent address on this domain. Typically an existing mailbox on the same organization. Example: catchall@example.com.

domainNamestringrequired

The fully-qualified domain name to set the catch-all address for, exactly as it is registered in Zoho Mail, e.g. example.com. Use zohomail_domain_list to look up the exact domain name if you're not sure of it.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns the domain. This is a numeric identifier assigned by Zoho, not the domain name or an email address — it is typically a large integer such as 60002018481. Obtain it by calling zohomail_org_get_organization for this connection first.

domainNamestringrequired

The fully-qualified domain name to add the DKIM key to, exactly as it is registered in Zoho Mail, e.g. example.com. Use zohomail_domain_list to look up the exact domain name if you're not sure of it.

selectorstringrequired

An identifier for this DKIM signature, published as part of the DNS selector record you'll add (selector._domainkey.<domain>). Any string is allowed — commonly a short label such as the key's purpose or creation date. Example: zmail2026.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns the domain. This is a numeric identifier assigned by Zoho, not the domain name or an email address — it is typically a large integer such as 60002018481. Obtain it by calling zohomail_org_get_organization for this connection first.

isDefaultboolean

Whether this new DKIM key should immediately become the default key Zoho Mail uses to sign outgoing mail for this domain. Defaults to false, meaning the key is created but not activated until you call zohomail_domain_set_dkim_default. Example: true.default false

keySizeinteger

The RSA key size in bits for the new DKIM key pair. Must be 1024 or 2048 — 2048 is more secure but produces a longer DNS TXT record. Leave unset to use Zoho's standard key size. Example: 2048.one of 10242048

domainNamestringrequired

The fully-qualified domain name to configure the notification address for, exactly as it is registered in Zoho Mail, e.g. example.com. Use zohomail_domain_list to look up the exact domain name if you're not sure of it.

notificationAddressstringrequired

The email address that should receive organization notifications for this domain, such as group email delivery failures (when a group has no moderator) and other domain-related alerts. Example: admin@example.com.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns the domain. This is a numeric identifier assigned by Zoho, not the domain name or an email address — it is typically a large integer such as 60002018481. Obtain it by calling zohomail_org_get_organization for this connection first.

domainNamestringrequired

The name of the domain to add to the organization. Example: zylker.com.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization the domain is being added to. Obtain it from Zoho Mail's Get Organization Details endpoint.

domainNamestringrequired

The fully-qualified domain name to disable subdomain stripping for, exactly as it is registered in Zoho Mail, e.g. example.com. Use zohomail_domain_list to look up the exact domain name if you're not sure of it.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns the domain. This is a numeric identifier assigned by Zoho, not the domain name or an email address — it is typically a large integer such as 60002018481. Obtain it by calling zohomail_org_get_organization for this connection first.

domainNamestringrequired

The name of the domain to enable email hosting for. Example: zylker.com.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization that owns the domain. Obtain it from Zoho Mail's Get Organization Details endpoint.

domainNamestringrequired

The fully-qualified domain name to enable subdomain stripping for, exactly as it is registered in Zoho Mail, e.g. example.com. Use zohomail_domain_list to look up the exact domain name if you're not sure of it.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns the domain. This is a numeric identifier assigned by Zoho, not the domain name or an email address — it is typically a large integer such as 60002018481. Obtain it by calling zohomail_org_get_organization for this connection first.

dkimIdintegerrequired

The unique ID of the DKIM configuration whose key pair should be regenerated. This is a numeric identifier returned by zohomail_domain_add_dkim or listed in a domain's details, not the selector string. Example: 60002018490.

domainNamestringrequired

The fully-qualified domain name whose DKIM key should be regenerated, exactly as it is registered in Zoho Mail, e.g. example.com. Use zohomail_domain_list to look up the exact domain name if you're not sure of it.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns the domain. This is a numeric identifier assigned by Zoho, not the domain name or an email address — it is typically a large integer such as 60002018481. Obtain it by calling zohomail_org_get_organization for this connection first.

domainAliasstringrequired

The name of the alias domain to remove from domainName. Example: zylker.org.

domainNamestringrequired

The name of the domain that domainAlias is currently pointing to. Example: zylker.com.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization that owns the domain. Obtain it from Zoho Mail's Get Organization Details endpoint.

dkimIdintegerrequired

The unique ID of the DKIM configuration to make the default for this domain. This is a numeric identifier returned by zohomail_domain_add_dkim or listed in a domain's details, not the selector string. Example: 60002018490.

domainNamestringrequired

The fully-qualified domain name whose default DKIM key should be changed, exactly as it is registered in Zoho Mail, e.g. example.com. Use zohomail_domain_list to look up the exact domain name if you're not sure of it.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns the domain. This is a numeric identifier assigned by Zoho, not the domain name or an email address — it is typically a large integer such as 60002018481. Obtain it by calling zohomail_org_get_organization for this connection first.

domainNamestringrequired

The name of the domain to set as the organization's primary domain. Example: zylker.com.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization that owns the domain. Obtain it from Zoho Mail's Get Organization Details endpoint.

dkimIdintegerrequired

The unique ID of the DKIM configuration to verify against DNS. This is a numeric identifier returned by zohomail_domain_add_dkim or listed in a domain's details, not the selector string. Example: 60002018490.

domainNamestringrequired

The fully-qualified domain name whose DKIM key should be verified, exactly as it is registered in Zoho Mail, e.g. example.com. Use zohomail_domain_list to look up the exact domain name if you're not sure of it.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns the domain. This is a numeric identifier assigned by Zoho, not the domain name or an email address — it is typically a large integer such as 60002018481. Obtain it by calling zohomail_org_get_organization for this connection first.

domainNamestringrequired

The name of the domain whose MX record should be verified. Example: zylker.com.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization that owns the domain. Obtain it from Zoho Mail's Get Organization Details endpoint.

domainNamestringrequired

The name of the domain to verify. Example: zylker.com.

modestringrequired

The verification method to use. Must be one of verifyDomainByTXT (verify via a TXT record in DNS), verifyDomainByCName (verify via a CNAME record in DNS), or verifyDomainByHTML (verify via an HTML file uploaded to the domain's web server).one of verifyDomainByTXTverifyDomainByCNameverifyDomainByHTML

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization that owns the domain. Obtain it from Zoho Mail's Get Organization Details endpoint.

domainNamestringrequired

The name of the domain whose SPF record should be verified. Example: zylker.com.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization that owns the domain. Obtain it from Zoho Mail's Get Organization Details endpoint.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox in which to create the new folder. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

folderNamestringrequired

Name for the new folder. Zoho Mail folder names must contain only letters — no spaces, numbers, or special characters are allowed. Example: "ProjectAlpha".

parentFolderIdstring

Numeric ID of the parent folder under which the new folder should be created as a subfolder. Omit to create the folder at the top level of the mailbox instead of nesting it. Obtain a folder's ID from zohomail_folder_list.

parentFolderPathstring

Path of the parent folder under which the new folder should be created, given as an alternative to parentFolderId. Example: "Inbox/Projects".

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox the folder belongs to. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

folder_idstringrequired

Numeric ID of the folder to hide from IMAP mail clients. Obtain it from zohomail_folder_list.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox the folder belongs to. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

folder_idstringrequired

Numeric ID of the folder to make viewable and accessible through IMAP. Obtain it from zohomail_folder_list.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox the folder belongs to. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

folder_idstringrequired

Numeric ID of the folder whose messages should all be marked as read. Obtain it from zohomail_folder_list.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox the folder belongs to. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

folder_idstringrequired

Numeric ID of the folder to move. Obtain it from zohomail_folder_list.

parentFolderIdstring

Numeric ID of the destination parent folder to move this folder under. Omit to move the folder to the top level of the mailbox. Obtain a folder's ID from zohomail_folder_list.

previousFolderIdstring

Numeric ID of the sibling folder, under the destination parent, after which this folder should be positioned. Use this to control ordering among sibling folders; omit to let Zoho Mail place it by default. Obtain a folder's ID from zohomail_folder_list.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox the folder belongs to. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

folder_idstringrequired

Numeric ID of the folder to rename. Obtain it from zohomail_folder_list.

folderNamestringrequired

New name for the folder, replacing its current name. Folder names in Zoho Mail typically allow only letters — no spaces, numbers, or special characters. Example: "ProjectBeta".

aliasesarrayrequired

Array of one or more email addresses to add as aliases for the group. Example: ["sales-alias@example.com", "support-alias@example.com"]

zgidstringrequired

Unique Zoho Group Identifier (ZGID) for the mail group to add aliases to. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns this group. This is a numeric ID, not the organization's name or domain. Obtain it by calling zohomail_org_get_organization for this connection first.

mailGroupMemberListarrayrequired

List of members to add. Each entry needs the member's email address, and may optionally set their role to 'member' (default) or 'moderator' — moderators can approve or reject held messages when the group is Moderated. Example: [{"memberEmailId": "alice@yourcompany.com", "role": "member"}].

zgidstringrequired

Unique identifier (zgid) of the mail group to add members to. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization that owns the group. This is a Zoho-generated internal identifier, typically a large integer such as 60000000012345. Obtain it by calling zohomail_org_get_organization for this connection first.

emailIdstringrequired

Email address for the new group, using a domain already verified in this Zoho Mail organization. This becomes the group's address that members send mail to. Example: engineering@yourcompany.com.

mailGroupMemberListarrayrequired

List of initial members to add to the group. Each entry needs the member's email address, and may optionally set their role to 'member' (default) or 'moderator' — moderators can approve or reject held messages when the group is Moderated. Example: [{"memberEmailId": "alice@yourcompany.com", "role": "member"}, {"memberEmailId": "bob@yourcompany.com", "role": "moderator"}].

namestringrequired

Unique display name for the group within the organization. Example: 'Engineering Team'.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization that will own this group. This is a Zoho-generated internal identifier, typically a large integer such as 60000000012345, and is required for every organization-level (admin) Zoho Mail API call. Obtain it by calling zohomail_org_get_organization for this connection first.

accessTypestring

Who can send mail to this group. 'Public' allows anyone to send, 'Organization' restricts to members of this organization, 'Group' restricts to group members only, and 'Moderated' requires a moderator to approve every message before delivery. Defaults to 'Public' if omitted.one of PublicOrganizationGroupModerateddefault Public

groupDescriptionstring

Free-text description of the group's purpose, shown to members and admins. Optional.

streamsEnabledboolean

Whether Streams (a group discussion feed) is enabled for this group at creation time. Defaults to false.default false

mailGroupMemberListarrayrequired

List of members to remove, identified by email address. Example: [{"memberEmailId": "alice@yourcompany.com"}].

zgidstringrequired

Unique identifier (zgid) of the mail group to remove members from. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization that owns the group. This is a Zoho-generated internal identifier, typically a large integer such as 60000000012345. Obtain it by calling zohomail_org_get_organization for this connection first.

zgidstringrequired

Unique identifier (zgid) of the mail group to enable streams on. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization that owns the group. This is a Zoho-generated internal identifier, typically a large integer such as 60000000012345. Obtain it by calling zohomail_org_get_organization for this connection first.

messageListarrayrequired

List of one or more held message IDs to moderate in this call, all receiving the same status. Obtain the IDs from zohomail_group_list_emails_held_moderation. Example: ["1234567000000012345", "1234567000000012346"].

statusstringrequired

Outcome to apply to every message in messageList. 'accept' delivers the message(s) to group members; 'reject' discards them.one of acceptreject

zgidstringrequired

Unique identifier (zgid) of the moderated mail group that holds the messages. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization that owns the group. This is a Zoho-generated internal identifier, typically a large integer such as 60000000012345. Obtain it by calling zohomail_org_get_organization for this connection first.

aliasesarrayrequired

Array of one or more alias email addresses to remove from the group. Example: ["sales-alias@example.com", "support-alias@example.com"]

zgidstringrequired

Unique Zoho Group Identifier (ZGID) for the mail group to remove aliases from. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns this group. This is a numeric ID, not the organization's name or domain. Obtain it by calling zohomail_org_get_organization for this connection first.

access_typestringrequired

Who can send mail to this group. 'Public' allows anyone, 'Organization' restricts to members of the organization, 'Group' restricts to group members only, and 'Moderated' requires moderator approval for every post.one of PublicOrganizationGroupModerated

zgidstringrequired

Unique Zoho Group Identifier (ZGID) for the mail group whose advanced admin settings are being updated. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns this group. This is a numeric ID, not the organization's name or domain. Obtain it by calling zohomail_org_get_organization for this connection first.

admin_notifyboolean

Whether the group administrator should be notified when a post requires moderation or is rejected. Defaults to false.default false

author_notifyboolean

Whether the sender of a held or rejected email should be notified. Defaults to false.default false

hold_or_bouncestring

For moderated or restricted posts, whether the email should be held for moderator approval ('hold') or rejected outright ('reject').one of holdreject

is_not_to_ccboolean

Controls whether the group address must appear in the To/Cc fields for the mail to be delivered to the group. Defaults to false.default false

mailbox_send_rightsboolean

Whether members of the group can send email as the group's mailbox address. Defaults to false.default false

post_approved_notifyboolean

Whether a notification should be sent once a held post is approved. Defaults to false.default false

spam_mark_permissionboolean

Whether group members are permitted to mark a message sent to the group as spam. Defaults to false.default false

suppress_mail_on_mem_addboolean

Whether the welcome/notification email that is normally sent to a member when they are added to the group should be suppressed. Defaults to false.default false

membersarrayrequired

Array of group members whose role should be changed. Each entry needs the member's email address and the destination role, either 'member' or 'moderator'. Example: [{"memberEmailId": "user@example.com", "role": "moderator"}]

zgidstringrequired

Unique Zoho Group Identifier (ZGID) for the mail group whose member role is being updated. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns this group. This is a numeric ID, not the organization's name or domain. Obtain it by calling zohomail_org_get_organization for this connection first.

membersarrayrequired

Array of group members to update, each identified by memberEmailId. Optionally include role (member or moderator; default member), status (active or deactive), ackStatus (boolean, whether an acknowledgement email should be sent to the member), and postApproval (accept, hold, or reject). Only include the fields you want to change for each member. Example: [{"memberEmailId": "user@example.com", "role": "moderator", "status": "active", "ackStatus": true, "postApproval": "accept"}]

zgidstringrequired

Unique Zoho Group Identifier (ZGID) for the mail group whose member settings are being updated. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns this group. This is a numeric ID, not the organization's name or domain. Obtain it by calling zohomail_org_get_organization for this connection first.

membersarrayrequired

Array of group members whose status should be changed. Each entry needs the member's email address and the destination status, either 'active' or 'deactive'. Example: [{"memberEmailId": "user@example.com", "status": "deactive"}]

zgidstringrequired

Unique Zoho Group Identifier (ZGID) for the mail group whose member status is being updated. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns this group. This is a numeric ID, not the organization's name or domain. Obtain it by calling zohomail_org_get_organization for this connection first.

namestringrequired

New display name for the group. Must be a plain string (a Zoho documentation page shows this field's type as 'long', but that is a documentation typo — group names are text, e.g. 'Engineering Team').

zgidstringrequired

Unique identifier (zgid) of the mail group to rename. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization that owns the group. This is a Zoho-generated internal identifier, typically a large integer such as 60000000012345. Obtain it by calling zohomail_org_get_organization for this connection first.

bounce_thresholdintegerrequired

Maximum number of email delivery failures (bounces) allowed for an external group member before Zoho Mail stops sending that member further mail from the group. Must be an integer between 1 and 100.

zgidstringrequired

Unique Zoho Group Identifier (ZGID) for the mail group whose bounce threshold is being updated. Obtain it by calling zohomail_group_list for this organization first.

zoidstringrequired

Unique Zoho Organization Identifier (ZOID) for the organization that owns this group. This is a numeric ID, not the organization's name or domain. Obtain it by calling zohomail_org_get_organization for this connection first.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to create the label in. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

display_namestringrequired

Name to give the new label, shown in the Zoho Mail UI and used when applying the label to messages. Example: "Urgent".

colorstring

Hexadecimal color for the label, such as #ff0000 for red. If omitted, Zoho Mail applies its own default label color (#ffd700, gold).

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox the label belongs to. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

label_idstringrequired

Numeric ID of the label to update, as returned in the labelId field by zohomail_label_list or zohomail_label_create. Example: 4000000012345.

colorstring

New hexadecimal color for the label, such as #00aaff. Leave unset to keep the label's current color. Provide at least one of Label Name or Color.

display_namestring

New name for the label. Leave unset to keep the label's current name. Provide at least one of Label Name or Color.

fromDateTimeintegerrequired

Start of the search range, as a Unix timestamp in milliseconds.

searchCriteriastringrequired

Which field to search on: 'messageId' to look up a specific message, 'fromAddr' to filter by sender address, or 'toAddr' to filter by recipient address.one of messageIdfromAddrtoAddr

searchKeystringrequired

The value to search for, matched against the field chosen in searchCriteria — a message ID, sender email address, or recipient email address.

toDateTimeintegerrequired

End of the search range, as a Unix timestamp in milliseconds.

zoidstringrequired

The unique Zoho Organization Identifier (zoid) for the organization whose SMTP logs to search. Obtain it from Zoho Mail's Get Organization Details endpoint (zohomail_org_get_organization).

isNextboolean

Set to true to retrieve the next page of results using the pageKey returned in the previous response; set to false (the default) for the initial request.default false

isPreviousboolean

Set to true to retrieve the previous page of results using the prevKey returned in the previous response; set to false (the default) for the initial request.default false

isReverseSearchboolean

Sort order for the results: true sorts ascending (oldest first), false (the default) sorts descending (most recent first).default false

limitinteger

Maximum number of SMTP log entries to return, from 1 to 500. Defaults to 10.default 10

pageKeystring

Pagination key returned in the previous response's pageKey field. Provide it together with isNext=true to fetch the next page; leave empty for the initial request.default

prevKeystring

Pagination key returned in the previous response's pagePrevKey field. Provide it together with isPrevious=true to fetch the previous page; leave empty for the initial request.default

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

label_idarrayrequired

One or more numeric label IDs to apply to the targeted messages. Obtain label IDs from Zoho Mail's label list for this account. Example: ["6000000056789"].

folder_idstring

Numeric ID of the folder to scope the labeling action to. Only messages present in this folder are considered when is_folder_specific is true; required in that case, ignored otherwise. Obtain it by calling zohomail_folder_list. Example: 6000000023456.

is_archiveboolean

Whether archived emails should be included when resolving the messages or threads to label. Default: false.default false

is_folder_specificboolean

Whether this labeling action should be scoped to only the messages of the given thread(s) that are present in a specific folder. Set to true and also provide folder_id to restrict it that way; otherwise leave false. Default: false.default false

message_idsarray

One or more numeric email message IDs to apply labels to. Obtain them from zohomail_message_list_search_results. Provide either message_ids or thread_ids — at least one of the two is required. Example: ["6000000034567"].

thread_idsarray

One or more thread IDs to apply labels to instead of individual messages; applies the labels to every message in each thread. Obtain them from zohomail_message_list_search_results. Provide either message_ids or thread_ids — at least one of the two is required. Example: ["6000000098765"].

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

message_idsarrayrequired

One or more numeric email message IDs to archive. Obtain them from zohomail_message_list_search_results. Example: ["6000000034567"].

thread_idsarray

One or more thread IDs to archive instead of individual messages; archives every message in each thread. Obtain them from zohomail_message_list_search_results. Example: ["6000000098765"].

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

flagidstringrequired

The flag to set on the messages. Choose "info" for an informational flag, "important" to mark important, "followup" to mark for follow-up, or "flag_not_set" to clear any existing flag. Example: "important".one of infoimportantfollowupflag_not_set

message_idsarrayrequired

One or more numeric email message IDs to flag. Obtain them from zohomail_message_list_search_results. Example: ["6000000034567"].

folder_idstring

Numeric ID of the folder to scope the flag action to. Only messages present in this folder are considered when is_folder_specific is true; required in that case, ignored otherwise. Obtain it by calling zohomail_folder_list. Example: 6000000023456.

is_archiveboolean

Whether archived emails should be included when resolving the messages or threads to flag. Default: false.default false

is_folder_specificboolean

Whether this flag action should be scoped to only the messages of the given thread(s) that are present in a specific folder. Set to true and also provide folder_id to restrict it that way; otherwise leave false. Default: false.default false

thread_idsarray

One or more thread IDs to flag as well, applying the flag to every message in each thread. Obtain them from zohomail_message_list_search_results. Example: ["6000000098765"].

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages to unmark as spam. This is a Zoho-generated internal identifier, not the user's email address, and is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

folder_idstring

Numeric ID of the folder to scope this action to. Required when is_folder_specific is true. Obtain it from zohomail_folder_list. Example: 116732000000008010.

is_folder_specificboolean

Whether to limit this action to messages within a single folder. When true, folder_id must also be provided and is required. Defaults to false.default false

message_idsarray

Array of message IDs to mark as not spam, as strings (Zoho message IDs are large integers that should be passed as strings to avoid precision loss). Either message_ids or thread_ids is required. Example: ["1198000000006002"].

thread_idsarray

Array of thread IDs to mark as not spam, as strings, as an alternative to message_ids for marking entire threads at once. Either message_ids or thread_ids is required. Example: ["1198000000006050"].

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages to mark as spam. This is a Zoho-generated internal identifier, not the user's email address, and is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

folder_idstring

Numeric ID of the folder to scope this action to. Required when is_folder_specific is true. Obtain it from zohomail_folder_list. Example: 116732000000008010.

is_folder_specificboolean

Whether to limit this action to messages within a single folder. When true, folder_id must also be provided. Defaults to false.default false

message_idsarray

Array of message IDs to mark as spam, as strings (Zoho message IDs are large integers that should be passed as strings to avoid precision loss). Either message_ids or thread_ids is required. Example: ["1198000000006002"].

thread_idsarray

Array of thread IDs to mark as spam, as strings, as an alternative to message_ids for marking entire threads at once. Either message_ids or thread_ids is required. Example: ["1198000000006050"].

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

message_idsarray

One or more numeric email message IDs to mark as read. Obtain them from zohomail_message_list_search_results. Provide either message_ids or thread_ids — at least one of the two is required. Example: ["6000000034567"].

thread_idsarray

One or more thread IDs to mark as read; marks every message in each thread as read. Obtain them from zohomail_message_list_search_results. Provide either message_ids or thread_ids — at least one of the two is required. Example: ["6000000098765"].

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

message_idsarray

One or more numeric email message IDs to mark as unread. Obtain them from zohomail_message_list_search_results. Provide either message_ids or thread_ids — at least one of the two is required. Example: ["6000000034567"].

thread_idsarray

One or more thread IDs to mark as unread; marks every message in each thread as unread. Obtain them from zohomail_message_list_search_results. Provide either message_ids or thread_ids — at least one of the two is required. Example: ["6000000098765"].

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

dest_folder_idstringrequired

Numeric ID of the folder the messages should be moved into. Obtain it by calling zohomail_folder_list for this account first. Example: 6000000023456.

folder_idstring

Numeric ID of the folder to scope the move to. Only messages present in this folder are considered when is_folder_specific is true; required in that case, ignored otherwise. Obtain it by calling zohomail_folder_list. Example: 6000000023456.

is_archiveboolean

Whether archived emails should be included when resolving the messages or threads to move. Default: false.default false

is_folder_specificboolean

Whether this move should be scoped to only the messages of the given thread(s) that are present in a specific folder. Set to true and also provide folder_id to restrict the move that way; otherwise leave false. Default: false.default false

message_idsarray

One or more numeric email message IDs to move. Obtain them from zohomail_message_list_search_results. Provide either message_ids or thread_ids — at least one of the two is required. Example: ["6000000034567"].

thread_idsarray

One or more thread IDs to move instead of individual messages; moves every message in each thread. Obtain them from zohomail_message_list_search_results. Provide either message_ids or thread_ids — at least one of the two is required. Example: ["6000000098765"].

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

message_idsarrayrequired

One or more numeric email message IDs to remove all labels from. Obtain them from zohomail_message_list_search_results. Example: ["6000000034567"].

folder_idstring

Numeric ID of the folder to scope the removal to. Only messages present in this folder are considered when is_folder_specific is true; required in that case, ignored otherwise. Obtain it by calling zohomail_folder_list. Example: 6000000023456.

is_folder_specificboolean

Whether this removal should be scoped to only the messages of the given thread(s) that are present in a specific folder. Set to true and also provide folder_id to restrict it that way; otherwise leave false. Default: false.default false

thread_idsarray

One or more thread IDs to remove all labels from as well, affecting every message in each thread. Obtain them from zohomail_message_list_search_results. Example: ["6000000098765"].

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user for this connection first.

label_idarrayrequired

One or more numeric label IDs to remove from the targeted messages. Obtain label IDs from Zoho Mail's label list for this account. Example: ["6000000056789"].

message_idsarrayrequired

One or more numeric email message IDs to remove labels from. Obtain them from zohomail_message_list_search_results. Example: ["6000000034567"].

folder_idstring

Numeric ID of the folder to scope the removal to. Only messages present in this folder are considered when is_folder_specific is true; required in that case, ignored otherwise. Obtain it by calling zohomail_folder_list. Example: 6000000023456.

is_folder_specificboolean

Whether this removal should be scoped to only the messages of the given thread(s) that are present in a specific folder. Set to true and also provide folder_id to restrict it that way; otherwise leave false. Default: false.default false

thread_idsarray

One or more thread IDs to remove labels from as well, affecting every message in each thread. Obtain them from zohomail_message_list_search_results. Example: ["6000000098765"].

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the message being replied to. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

from_addressstringrequired

Sender's email address for the reply. Must be one of the addresses associated with the authenticated Zoho Mail account.

message_idstringrequired

Unique numeric ID of the email being replied to. Obtain it from a message-listing tool such as zohomail_message_list_search_results.

to_addressstringrequired

Recipient email address(es) for the reply. For multiple recipients, separate addresses with commas.

ask_receiptstring

Whether to request a read receipt from the recipient. Set to 'yes' to request one, or 'no' (or leave blank) to skip it.one of yesno

bcc_addressstring

Blind carbon copy recipient(s) for this reply. For multiple addresses, separate them with commas.

cc_addressstring

Carbon copy recipient(s) for this reply. For multiple addresses, separate them with commas.

encodingstring

Character encoding of the reply. Defaults to UTF-8.one of UTF-8Big5EUC-JPEUC-KRGB2312ISO-2022-JPISO-8859-1KOI8-RShift_JISUS-ASCIIWINDOWS-1251X-WINDOWS-ISO2022JPdefault UTF-8

is_scheduleboolean

Set to true to schedule this reply for later delivery instead of sending it immediately. When true, also set schedule_type (and time_zone/schedule_time for a custom time).default false

mail_formatstring

Format of the reply body. 'html' for HTML content, 'plaintext' for plain text. Defaults to html.one of htmlplaintextdefault html

schedule_timestring

Exact delivery date/time, formatted MM/DD/YYYY HH:MM:SS. Required only when schedule_type is 6 (custom).

schedule_typeinteger

Preset delay for scheduled delivery, used only when is_schedule is true: 1 = 1 hour, 2 = 2 hours, 3 = 4 hours, 4 = next morning, 5 = next afternoon, 6 = custom (requires time_zone and schedule_time).one of 123456

subjectstring

Subject line of the reply. Typically the original subject prefixed with 'Re:'.

time_zonestring

Time zone to use when scheduleType is 6 (custom), e.g. 'GMT 5:30'. Required only in that case.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to save the item under. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

from_addressstringrequired

Sender's email address. Must be one of the addresses associated with the authenticated Zoho Mail account.

modestringrequired

Whether to save this item as a 'draft' (a work-in-progress email you can send later) or a 'template' (a reusable message you can start new emails from).one of drafttemplate

to_addressstringrequired

Recipient email address(es). For multiple recipients, separate addresses with commas.

ask_receiptstring

Whether to request a read receipt from the recipient. Set to 'yes' to request one, or 'no' (or leave blank) to skip it.one of yesno

bcc_addressstring

Blind carbon copy recipient(s) for this item. For multiple addresses, separate them with commas.

cc_addressstring

Carbon copy recipient(s) for this item. For multiple addresses, separate them with commas.

contentstring

Body content of the item, formatted according to mail_format (HTML markup if 'html', plain text if 'plaintext').

encodingstring

Character encoding of the item. Defaults to UTF-8.one of UTF-8Big5EUC-JPEUC-KRGB2312ISO-2022-JPISO-8859-1KOI8-RShift_JISUS-ASCIIWINDOWS-1251X-WINDOWS-ISO2022JPdefault UTF-8

in_reply_tostring

The Message-ID header value of the email being replied to. Required only when saving a reply draft (i.e. this draft continues an existing thread).

mail_formatstring

Format of the item's body. 'html' for HTML content, 'plaintext' for plain text. Defaults to html.one of htmlplaintextdefault html

ref_headerstring

Message-IDs of every prior email in the thread, space-separated in chronological order. Required only for a threaded reply draft, alongside in_reply_to.

subjectstring

Subject line of the item.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to send from. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

from_addressstringrequired

Sender's email address. Must be one of the addresses associated with the authenticated Zoho Mail account.

to_addressstringrequired

Recipient email address(es). For multiple recipients, separate addresses with commas.

ask_receiptstring

Whether to request a read receipt from the recipient. Set to 'yes' to request one, or 'no' (or leave blank) to skip it.one of yesno

bcc_addressstring

Blind carbon copy recipient(s) for this email. For multiple addresses, separate them with commas.

cc_addressstring

Carbon copy recipient(s) for this email. For multiple addresses, separate them with commas.

contentstring

Body content of the email, formatted according to mail_format (HTML markup if 'html', plain text if 'plaintext').

encodingstring

Character encoding of the email. Defaults to UTF-8.one of UTF-8Big5EUC-JPEUC-KRGB2312ISO-2022-JPISO-8859-1KOI8-RShift_JISUS-ASCIIWINDOWS-1251X-WINDOWS-ISO2022JPdefault UTF-8

is_scheduleboolean

Set to true to schedule this email for later delivery instead of sending it immediately. When true, also set schedule_type (and time_zone/schedule_time for a custom time).default false

mail_formatstring

Format of the email body. 'html' for HTML content, 'plaintext' for plain text. Defaults to html.one of htmlplaintextdefault html

schedule_timestring

Exact delivery date/time, formatted MM/DD/YYYY HH:MM:SS. Required only when schedule_type is 6 (custom).

schedule_typeinteger

Preset delay for scheduled delivery, used only when is_schedule is true: 1 = 1 hour, 2 = 2 hours, 3 = 4 hours, 4 = next morning, 5 = next afternoon, 6 = custom (requires time_zone and schedule_time).one of 123456

subjectstring

Subject line of the email.

time_zonestring

Time zone to use when scheduleType is 6 (custom), e.g. 'GMT 5:30'. Required only in that case.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox to send from. This is a Zoho-generated internal identifier assigned when the mail account was added — it is not the user's email address, and it is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

from_addressstringrequired

Sender's email address. Must be one of the addresses associated with the authenticated Zoho Mail account.

to_addressstringrequired

Recipient email address(es). For multiple recipients, separate addresses with commas.

ask_receiptstring

Whether to request a read receipt from the recipient. Set to 'yes' to request one, or 'no' (or leave blank) to skip it.one of yesno

attachmentsarray

Files to attach, each referencing a file already uploaded via Zoho Mail's Upload Attachment endpoint. Each entry is an object with storeName, attachmentPath, and attachmentName. Example: [{"storeName": "zm123456", "attachmentPath": "/1/1234000000012345", "attachmentName": "invoice.pdf"}].

bcc_addressstring

Blind carbon copy recipient(s) for this email. For multiple addresses, separate them with commas.

cc_addressstring

Carbon copy recipient(s) for this email. For multiple addresses, separate them with commas.

contentstring

Body content of the email, formatted according to mail_format (HTML markup if 'html', plain text if 'plaintext').

encodingstring

Character encoding of the email. Defaults to UTF-8.one of UTF-8Big5EUC-JPEUC-KRGB2312ISO-2022-JPISO-8859-1KOI8-RShift_JISUS-ASCIIWINDOWS-1251X-WINDOWS-ISO2022JPdefault UTF-8

is_scheduleboolean

Set to true to schedule this email for later delivery instead of sending it immediately. When true, also set schedule_type (and time_zone/schedule_time for a custom time).default false

mail_formatstring

Format of the email body. 'html' for HTML content, 'plaintext' for plain text. Defaults to html.one of htmlplaintextdefault html

schedule_timestring

Exact delivery date/time, formatted MM/DD/YYYY HH:MM:SS. Required only when schedule_type is 6 (custom).

schedule_typeinteger

Preset delay for scheduled delivery, used only when is_schedule is true: 1 = 1 hour, 2 = 2 hours, 3 = 4 hours, 4 = next morning, 5 = next afternoon, 6 = custom (requires time_zone and schedule_time).one of 123456

subjectstring

Subject line of the email.

time_zonestring

Time zone to use when scheduleType is 6 (custom), e.g. 'GMT 5:30'. Required only in that case.

account_idstringrequired

Numeric Zoho Mail account ID identifying the mailbox that owns the messages to unarchive. This is a Zoho-generated internal identifier, not the user's email address, and is typically a large integer such as 6000000012345. Obtain it by calling zohomail_account_list_user first.

message_idsarrayrequired

Array of message IDs to unarchive, as strings (Zoho message IDs are large integers that should be passed as strings to avoid precision loss). Retrieve these from the list emails endpoint. Example: ["1198000000006002"].

thread_idsarray

Array of thread IDs to unarchive as strings, as an alternative to message_ids for unarchiving entire threads at once. Example: ["1198000000006050"].

contentstringrequired

Body content of the note. This field is required and cannot be empty.

group_idstringrequired

Unique ID of the notes group the note belongs to. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_note_list_groups for this connection first.

book_idstring

Unique ID of the notebook (book) to associate this note with. Optional — omit to leave the note unfiled. Obtain from zohomail_note_list_books.

colorinteger

Color to apply to the note. Valid values: 0=Blue, 1=Green, 2=Yellow, 3=Red. Leave unset to use Zoho Mail's default note color.one of 0123

tag_idarray

One or more label (tag) IDs to attach to the note, as a JSON array of ID strings. Optional. Obtain tag IDs from zohomail_label_list.

titlestring

Title to give the note. Optional — the note can be created without one.

book_namestringrequired

Name to give the new notebook. Required.

group_idstringrequired

Unique ID of the notes group to create the notebook in. This is a Zoho-generated internal identifier, typically a large integer such as 70000000054321. Obtain it by calling zohomail_note_list_groups for this connection first.

contentstringrequired

New content for the note. This field cannot be empty — it always overwrites the note's existing content.

group_idstringrequired

Unique ID of the Zoho Mail Notes group that owns the note. This is a Zoho-generated internal identifier (a large integer) specific to the Notes API. Obtain it by calling zohomail_note_list_groups for this connection first.

note_idstringrequired

Unique ID of the note to update. Obtain it by calling zohomail_note_list for this group first.

book_idstring

Unique ID of the notebook (book) to move this note into. Leave blank to keep the note in its current notebook. Obtain it by calling zohomail_note_list_books for this group first.

colorinteger

New color designation for the note: 0=Blue, 1=Green, 2=Yellow, 3=Red. Leave blank to keep the note's existing color.one of 0123

tag_idsarray

Array of label (tag) IDs to attach to the note, replacing any existing tags. Leave blank to keep the note's existing tags. Obtain label IDs by calling zohomail_label_list first. Example: ["190000000011111","190000000022222"].

titlestring

New title for the note. Leave blank to keep the note's existing title.

book_idstringrequired

Unique ID of the notebook (book) to rename. Obtain it by calling zohomail_note_list_books for this group first.

book_namestringrequired

New name for the notebook.

group_idstringrequired

Unique ID of the Zoho Mail Notes group that owns the notebook. This is a Zoho-generated internal identifier (a large integer) specific to the Notes API. Obtain it by calling zohomail_note_list_groups for this connection first.

group_idstringrequired

Unique ID of the Zoho Mail Notes group that owns the note. This is a Zoho-generated internal identifier (a large integer) specific to the Notes API. Obtain it by calling zohomail_note_list_groups for this connection first.

note_idstringrequired

Unique ID of the note to mark as a favorite. Obtain it by calling zohomail_note_list for this group first.

allowed_ipsarrayrequired

List of allowed IP-range entries to add. Each entry is an object with fromIpRange (start of the range), toIpRange (end of the range), and roleId (0=Users, 1=Admins, 2=Super Admin, -1=all members). Example: [{"fromIpRange": "192.168.1.1", "toIpRange": "192.168.1.255", "roleId": 0}]

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization to add allowed IPs to. Obtain it by calling zohomail_org_get_organization first.

domain_namestringrequired

Domain name to register for the new child organization, e.g. example-corp.com. This becomes the primary mail domain for the organization.

email_idstringrequired

Email address of the super admin account to create for the new child organization. Must be a valid email on the domain being registered.

first_namestringrequired

First name of the super admin for the new child organization.

last_namestringrequired

Last name of the super admin for the new child organization.

org_namestringrequired

Display name of the new child organization.

passwordstringrequired

Password to set for the new super admin account. Treat as sensitive.

plan_namestring

Enrolled plan type for the new organization. One of basicTrial, professionalTrial, mailPremiumTrial, or free. Leave unset to use Zoho's default plan.one of basicTrialprofessionalTrialmailPremiumTrialfree

spam_categorystringrequired

The type of spam listing to add or update, e.g. whiteListEmail, spamEmail, rejectDomain, quarantineIP, spamTLD.one of whiteListEmailspamEmailrejectEmailquarantineEmailtrustedEmailwhiteListDomainspamDomainrejectDomainquarantineDomaintrustedDomainwhiteListIPspamIPrejectIPquarantineIPspamTLDrejectTLDquarantineTLDrecipientSpamEmailrecipientRejectEmailrecipientQuarantineEmail

valuesarrayrequired

Email addresses, domains, or IP addresses to add or update for the selected spam category. Example: ["spam@example.com", "baddomain.com"]

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

spam_process_typestringrequired

The spam process to apply for the organization. One of Off (disable spam processing), complete, content, sender, or sender_header.one of Offcompletecontentsendersender_header

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

modestringrequired

Which storage update operation to perform: updateBaseStorage changes the user's base plan (requires plan_type), or updateExtraStorage adds storage add-ons (requires add_on_type).one of updateBaseStorageupdateExtraStorage

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the organization. Obtain it by calling zohomail_org_get_organization first.

zuidstringrequired

Unique Zoho User Identifier (zuid) for the user whose storage to update. Obtain it from Zoho Mail's User Account Details endpoint.

add_on_typearray

Required when mode is updateExtraStorage; ignored otherwise. Add-on storage units in 'Xgb:quantity' format, e.g. ["25gb:1", "5gb:2"]. Valid size values: 5gb, 25gb, 50gb, 100gb, 200gb.

plan_typestring

Required when mode is updateBaseStorage; ignored otherwise. The new base storage plan for the user. One of newMail5gb, newMail10gb, mailPremium, basic, professional.one of newMail5gbnewMail10gbmailPremiumbasicprofessional

access_restriction_idstringrequired

Unique identifier of the access restriction to add allowed IP ranges to. Obtain it by calling zohomail_policy_list_access_restrictions for this organization first.

ip_restrictionarrayrequired

The IP ranges to allow, as an array of objects. Each object needs a startIP and endIP marking the beginning and end of an allowed IP address range, and may include a description noting what the range is for. Example: [{"startIP": "192.168.1.1", "endIP": "192.168.1.255", "description": "Office network"}].

zoidstringrequired

Unique Zoho Organization Identifier (zoid) for the Zoho Mail organization. Obtain it by calling zohomail_org_get_organization for this connection first.