agentmail-sending

# AgentMail Sending ## Canonical Base URL Use this base URL exactly: ```text https://api.agentmail.to/v0/ ``` DO NOT use `api.agentmail.ai`. That host is a hallucination and will not send mail through AgentMail's current API. ## Canonical Send-Message Fields For `POST /inboxes/{inbox}/messages/send`, the JSON body fields are exactly: ```text to bcc subject text ``` Use `text`, NOT `text_body`, `body`, or `content`. Do NOT pass `html`. AgentMail has a known rendering bug: when `html` is passed with `text`, the HTML body can be empty and email clients may show a blank email. AgentMail renders `text` correctly on its own. ## Rule 0: One-Shots Stay One-Shots For a one-off send, such as a kickoff email or a single notification, do not create a reusable swarm-script. Use raw `curl` from Bash, or inline `script_run` if you need swarm-visible execution. Only use `script_upsert` when the send will be reused by a workflow that fires repeatedly. ## Default Example: Raw curl Use this direct API call first. It does not assume any SDK is installed. Endpoint: ```text https://api.agentmail.to/v0/inboxes/{inbox}/messages/send ``` ```bash INBOX="<agentmail-inbox-id>" curl -sS -X POST "https://api.agentmail.to/v0/inboxes/${INBOX}/messages/send" \ -H "Authorization: Bearer $AGENTMAIL_API_KEY" \ -H "Content-Type: application/json" \ --data-binary @- <<'JSON' { "to": ["recipient@example.com"], "bcc": ["oversight@example.com"], "subject": "Subject line", "text": "Pla...