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

Accepted

401

Missing API key or key lacks permission

403

Invalid API key, unverified domain, or sending paused

404

Not found

422

Validation error

429

Rate limit (10 requests per second for this API) or daily quota exceeded; see the retry-after header