SEND_EMAIL
Send an email. Supports multiple recipients, CC/BCC, HTML body, and file attachments.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
to | string | yes | Recipient email(s), comma-separated for multiple |
subject | string | yes | Email subject line |
body | string | yes | Plain-text email body |
html | string | — | Optional HTML body (sent alongside plain text as alternative) |
cc | string | — | CC recipients, comma-separated |
bcc | string | — | BCC recipients, comma-separated |
attachments | string | — | Comma-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.