Transactional email, one POST away
Send single, batch, or broadcast email over REST. Requests are accepted in milliseconds and delivered directly to recipient mail servers from EU infrastructure.
Queued in one request
POST to /v1/emails with an HTML body, a text body, or a template alias. The API answers 202 with an id you can follow through queued, processing, and sent, by polling or receiving webhook events. Sent means the recipient mail server accepted the message; it does not confirm inbox placement. Attachments go inline as base64, up to a 2 MB request body.
curl -X POST https://api.euromail.dev/v1/emails \
-H "X-EuroMail-Api-Key: em_live_..." \
-H "Content-Type: application/json" \
-d '{
"from": "[email protected]",
"to": "[email protected]",
"subject": "Welcome aboard",
"html_body": "<h1>Hello!</h1>"
}'
202 Accepted { "status": "queued" }Safe to retry
An idempotency_key guarantees a send is accepted at most once. A network retry returns the original result instead of a duplicate email. Batch sends report a per-message errors array, so one bad recipient does not fail the remaining messages. Sandbox mode exercises the full pipeline without a single message leaving.
- Idempotency
- At-most-once accept per key
- Batch errors
- Per-message, batch never fails whole
- Sandbox
- Full validation, no mail leaves
- Status lifecycle
- queued → processing → sent