Sending

One request, and the rest is handled.

Send transactional email with a single POST. Every message is queued, tracked and recorded from accepted to delivered.

POST /v1/emails takes a JSON body and answers 201 with the new email's id. The message is queued straight away and sent within seconds, so your request returns without waiting on a mail server. One send takes up to 50 recipients across to, cc and bcc, with HTML, plain text or both.

Everything you would otherwise build yourself is already there: attachments up to 7 MB, custom headers, up to 10 tags for filtering, and scheduling up to 30 days ahead with the option to cancel. Send an idempotency key with anything you might retry and a repeat returns the original email instead of sending twice.

  • Accepted in milliseconds, queued and retried on your behalf
  • Attachments, tags, custom headers and scheduled sends
  • Idempotency keys so a retry can never send twice
POST /v1/emails
curl -X POST https://api.avelto.dev/v1/emails \
  -H "Authorization: Bearer av_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <[email protected]>",
    "to": "[email protected]",
    "subject": "Your receipt",
    "html": "<p>Thanks for your order.</p>"
  }'

More of what Avelto does