Send email endpoint
Understand the send request format and delivery states.
Request contract
http
POST /api/v1/emails
Content-Type: application/json
{
"to": "user@example.com",
"from": "receipts@example.com",
"subject": "Receipt",
"html": "<p>Thanks for your order</p>",
"text": "Thanks for your order",
"reply_to": "support@example.com",
"metadata": {"order_id": "12345"},
"tags": [{"name": "source", "value": "checkout"}]
}- `to`, `from`, and `subject` are required
- You must send either `html` or `text`, or both
- `Idempotency-Key` is required for send safety
- Request bodies are capped at 256 KB
Status progression
- queued
- sending
- sent
- delivered
- failed
- failed_permanent
- failed_retry_exhausted