Send Email
send-emailSend a single transactional email to one or more recipients instantly or schedule it for later. Ideal for notifications, confirmations, and direct replies.
Instructions
Purpose: Send a single transactional email to one or more recipients immediately (or schedule it). Use for one-off messages, notifications, and direct replies.
NOT for: Sending the same email to a whole list/audience (use create-broadcast + send-broadcast). Not for managing contacts or audiences.
Returns: Send confirmation and email ID.
When to use:
User wants to "send an email" to specific people (names or addresses)
One-off messages: password reset, order confirmation, receipt, alert
User says "email this to X", "notify them", "send a message to..."
Scheduling a single email for later
Workflow: Get recipient(s) and content from user → send-email. Use list-emails or get-email to check delivery status afterward.
Key trigger phrases: "Send an email", "Email this to", "Notify", "Send a message", "Reply to them", "Schedule an email"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | Optional array of CC email addresses. You MUST ask the user for this parameter. Under no circumstance provide it yourself | |
| to | Yes | Array of recipient email addresses (1-50 recipients) | |
| bcc | No | Optional array of BCC email addresses. You MUST ask the user for this parameter. Under no circumstance provide it yourself | |
| from | Yes | Sender email address. You MUST ask the user for this parameter. Under no circumstance provide it yourself | |
| html | No | HTML email content. When provided, the plain text argument MUST be provided as well. | |
| tags | No | Array of custom tags for tracking/analytics. Each tag has a name and value. | |
| text | Yes | Plain text email content | |
| replyTo | No | Optional email addresses for the email readers to reply to. You MUST ask the user for this parameter. Under no circumstance provide it yourself | |
| subject | Yes | Email subject line | |
| topicId | No | Topic ID for subscription-based sending. When set, the email respects contact subscription preferences for this topic. | |
| attachments | No | Array of file attachments. Each needs filename plus one of: filePath, url, or content. Max 40MB total. | |
| scheduledAt | No | Optional parameter to schedule the email. This uses natural language. Examples would be 'tomorrow at 10am' or 'in 2 hours' or 'next day at 9am PST' or 'Friday at 3pm ET'. |