Send an email
POST/emails
Sends one email. The from address must be on a domain you have verified (a 403 names the domain otherwise). Up to 50 recipients across to, cc and bcc; up to 50 attachments as base64 content (attachments by path URL are not supported yet), with the whole message under 40 MB. Pass scheduled_at to send later (cancel or reschedule until then), template to render a published template with variables, and tags to filter events and metrics.
Send an Idempotency-Key header to make retries safe: the same key with the same body returns the first result, the same key with a different body fails with invalid_idempotent_request.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
Accepted
Missing API key or key lacks permission
Invalid API key, unverified domain, or sending paused
Not found
Validation error
Rate limit (10 requests per second for this API) or daily quota exceeded; see the retry-after header