> Source: https://builder.ema.ai/v2/agent-reference/send-email
> Title: Send Email

# Send Email

Send Email sends an email through a connected Outlook or Gmail mailbox. Give it a recipient, subject, and body, and it dispatches the message through the mailbox integration attached to the node — with **no LLM call** on the send itself.

Send Email belongs to the **Generation** group in the agent library. Under the hood it runs as a Custom agent (`custom_agent`) — the agent service forwards the node's inputs to the custom-action service, which executes the agent and returns its output. See [Custom Agent](/builder/v2/agent-reference/custom) for how the `custom_agent` dispatch mechanism works.

## When to use it

Use Send Email as the last node in a workflow that needs to deliver a message rather than just produce text:

-   Reply to an inbound support email once a [Custom Agent](/builder/v2/agent-reference/custom) or [Document Writer Agent](/builder/v2/agent-reference/document-writer) has composed the response.
-   Notify a stakeholder when a workflow reaches a particular state.
-   Send a generated document or summary directly to a recipient's inbox.

Send Email requires a mailbox integration (Outlook or Gmail) to be connected to the node before it can run.

## Configuration

Add the agent to a workflow as a Custom agent and pin it by ID in `agent_config.type_config`:

```json
{ "custom_agent_id": "send_email_agent" }
```

Input key

Required

Purpose

`to_email`

Yes

The recipient email address (or a list of addresses).

`subject`

Yes

The email subject line.

`email_body`

Yes

The email body content.

## Inputs and output

**Input**

```json
{
  "to_email": "alice@example.com",
  "subject": "Re: Order #4821 delay",
  "email_body": "Hi Alice, your order is scheduled to ship tomorrow. Thanks for your patience!"
}
```

**Output**

```json
{ "status": "sent" }
```

A downstream node reads the send status via `{{<node_id>.output.status}}`.

## What's next

-   [Custom Agent](/builder/v2/agent-reference/custom) — how the `custom_agent` dispatch this agent runs on works.
-   [Email Parser Agent](/builder/v2/agent-reference/email-parser) — parse the inbound email this workflow is replying to.
-   [Document Writer Agent](/builder/v2/agent-reference/document-writer) — draft the content Send Email delivers.