> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho Mail

> Zoho Mail lets you manage email, folders, labels, and personal tasks via your connected account.

Use Zoho Mail when you need to work with email, folders, labels, or personal tasks in a workflow. It can read messages, send replies, and update mailbox state.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Zoho Mail account to use for this step. |
| Action | Yes | The Zoho Mail action to perform (for example List Zoho Mail Accounts, List Folders, Get Folder, List Emails). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Zoho Mail in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **List Zoho Mail Accounts** | Retrieve the Zoho Mail accounts connected to the user. |
| **List Folders** | List every folder in a Zoho Mail account. |
| **Get Folder** | Retrieve one folder by account and folder ID. |
| **List Emails** | Retrieve emails from a Zoho Mail account. |
| **Search Messages** | Search emails in a Zoho Mail account using Zoho search syntax. |
| **Get Message Content** | Retrieve the full body and content of one email. |
| **Send Email** | Send an email immediately or schedule it for later. |
| **Reply to Email** | Send a reply while preserving the original thread. |
| **Create Email Draft** | Create and save an email draft without sending it. |
| **Update Messages** | Batch update message state such as read, folder, flag, label, archive, or spam. |
| **List Labels** | List every label configured in a Zoho Mail account. |
| **Create Label** | Create a new label in a Zoho Mail account. |
| **List Personal Tasks** | List personal tasks for the connected user. |
| **Create Personal Task** | Create a personal task for the connected user. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Zoho Mail response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Zoho Mail if you have not already done that.
2. Add a **Zoho Mail** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **List Zoho Mail Accounts** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Triage incoming mail

1. List Emails
2. Search Messages
3. Get Message Content
4. Update Messages

### Send a follow-up

1. List Emails
2. Get Message Content
3. Reply to Email

### Organize mail items

1. List Labels
2. Create Label
3. List Folders
4. Create Folder

## Notes

* This step depends on a connected Zoho Mail integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Zoho Mail tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Zoho Mail as an Agent Tool

You can also add Zoho Mail as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Zoho Mail**. In the tool settings panel, choose the connected account the agent should use. The agent calls Zoho Mail actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.