email_send
Adding a welcome, receipt, status, or alert email to an app? email_send sends one transactional email to one recipient on every plan. Without from, the platform-managed sender is used immediately; the project name appears as the sender label. from selects a verified sender domain of the app. Domains bought through us or connected with our nameservers are set up automatically; a domain hosted elsewhere is verified once in Settings → Domains. A caller cannot explicitly name a platform domain.
The platform-managed sender is transactional-only. A verified sender domain carries the branding of the app itself and its marketing email. Outbound transactional email is available on Free, Builder, Pro, Scale, and Enterprise. The plan's email allowance and send rate limit apply either way; current limits are at /v1/pricing. It takes html or text (or both). reply_to is optional.
Example:
{
"project_id": "my-saas",
"to": "alice@example.com",
"subject": "Your order shipped",
"html": "<p>Tracking number: ABC123</p>"
}Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>",
"to": "<to>",
"subject": "<subject>"
},
"name": "email_send"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Recipient email address | |
| from | No | Optional sender on a verified sender domain. Omission selects the platform-managed transactional sender with the project name as its label. | |
| html | No | HTML body. Optional if text is set. | |
| text | No | Plaintext body. Optional if html is set. | |
| subject | Yes | Email subject line | |
| reply_to | No | Optional reply-to address. | |
| project_id | Yes | Project ID (UUID), subdomain, or slug — resolved server-side, no UUID lookup needed. 'default' also works when the account has exactly one project; multi-project accounts must name one (the error lists them). |