send_email
Send transactional emails from a registered sender. Confirm recipient, subject, and content with user before sending to use credits.
Instructions
Send a transactional email from a registered sender address.
Costs 1 credit per recipient (to + each cc + each bcc). At least one of body (plain text) or html is required.
Call list_email_senders first to confirm from_email is registered. ALWAYS confirm to, subject, from_email, and body/html with the user before sending — this spends real credits and delivers a real email.
Args: to: Recipient email address (e.g. customer@example.com). from_email: Registered sender address on a verified domain (e.g. noreply@yourdomain.com). Use list_email_senders to find valid values. subject: Email subject line (max 500 chars). body: Plain-text body. At least one of body or html is required. html: Optional HTML body (e.g. "Hello"). Provide alongside body as a fallback for clients that don't render HTML. from_name: Optional display name shown in the recipient's inbox (e.g. "Duka Masta Billing"). cc: Optional list of CC addresses. Each costs 1 credit. bcc: Optional list of BCC addresses. Each costs 1 credit. reply_to: Optional reply-to address if different from from_email. schedule_at: Optional future delivery time in ISO-8601 (e.g. 2026-06-15T09:00:00Z). Naive datetimes (no Z/offset) are treated as EAT (Africa/Dar_es_Salaam, UTC+3). Leave empty to send immediately. tags: Optional string labels for filtering in message history (max 10).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | ||
| to | Yes | ||
| bcc | No | ||
| body | No | ||
| html | No | ||
| tags | No | ||
| subject | Yes | ||
| reply_to | No | ||
| from_name | No | ||
| from_email | Yes | ||
| schedule_at | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |