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 agent (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 agent'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 agent 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 agent 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 agent 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.