Sending email
POST /emails accepts a JSON body (and optional Idempotency-Key).
Minimal example
{
"from": "evre <hi@mail.evre.email>",
"to": ["user@example.com"],
"subject": "Hello",
"html": "<p>Hi</p>",
"text": "Hi"
}
Common fields
| Field | Notes |
|---|---|
to / cc / bcc / replyTo | String or array of addresses |
html / text | At least one body is required |
tags | [{ "name", "value" }] — indexed on the message |
routeId | Optional route (defaults to project’s default transactional route) |
scheduledAt | ISO time — see Scheduling |
attachments | Base64 content — see Attachments |
from must use a verified domain for the project (or mock provider allowlist in local/demo).
Retrieve and list
GET /emails/{id}— message + event timelineGET /emails?limit=50— recent messages