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 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 or Document Writer Agent 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:
{ "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
{
"to_email": "[email protected]",
"subject": "Re: Order #4821 delay",
"email_body": "Hi Alice, your order is scheduled to ship tomorrow. Thanks for your patience!"
}Output
{ "status": "sent" }A downstream node reads the send status via {{<node_id>.output.status}}.
What's next
- Custom Agent — how the
custom_agentdispatch this agent runs on works. - Email Parser Agent — parse the inbound email this workflow is replying to.
- Document Writer Agent — draft the content Send Email delivers.