← All toolsCommunicationemailAll editions

SEND_EMAIL

Send an email. Supports multiple recipients, CC/BCC, HTML body, and file attachments.

Parameters

NameTypeRequiredDescription
tostringyesRecipient email(s), comma-separated for multiple
subjectstringyesEmail subject line
bodystringyesPlain-text email body
htmlstringOptional HTML body (sent alongside plain text as alternative)
ccstringCC recipients, comma-separated
bccstringBCC recipients, comma-separated
attachmentsstringComma-separated absolute file paths to attach

How to use it

You normally trigger this by describing what you want in chat — the agent selects SEND_EMAIL automatically. For example:

Try saying
“email the Q3 summary to sam@acme.com”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "email",
  "action": "SEND_EMAIL",
  "args": {
    "to": "name@example.com",
    "subject": "Hello",
    "body": "…"
  },
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"SEND_EMAIL","args":{"to":"name@example.com","subject":"Hello","body":"…"}}'

Part of the email plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.