Send API

Transactional email over a plain HTTPS API, with verified domains, templates, suppressions, and webhooks

send.dev is a transactional email API. You verify a domain (or a single address), then send email with one HTTPS request. Delivery runs on Amazon SES with per-account reputation isolation, and every message is tracked so you can poll its status or list your history.

The API is HTTP + JSON with nothing to install. Every example in these docs uses curl, Node's fetch, or Python's requests.

Base URL

https://api.do.dev/v1/send

https://api.send.dev/v1/... is an alias for the same API with identical behavior (for example https://api.send.dev/v1/emails/send). Use whichever you prefer; the docs use api.do.dev.

Authentication

Every request carries an API key created in the dashboard:

Authorization: Bearer do_live_...

See Authentication for details, including the X-API-Key header and legacy sk_live_ keys.

Endpoints

Emails

MethodPathDescription
POST/v1/send/emails/sendSend an email
POST/v1/send/emails/batchSend up to 100 emails
GET/v1/send/emails/{id}Get an email
GET/v1/send/emailsList emails

Domains and senders

MethodPathDescription
GET/v1/send/domainsList domains
POST/v1/send/domainsAdd a domain
POST/v1/send/domains/{id}/verifyCheck DNS and verify
DELETE/v1/send/domains/{id}Delete a domain
GET/v1/send/sendersList sender addresses
POST/v1/send/senders/verifyVerify a single address
GET/v1/send/senders/{id}/statusCheck verification status
DELETE/v1/send/senders/{id}Delete a sender

Templates and suppressions

MethodPathDescription
GET/v1/send/templatesList templates
POST/v1/send/templatesCreate a template
GET/v1/send/templates/{id}Get a template
PUT/v1/send/templates/{id}Update a template
DELETE/v1/send/templates/{id}Delete a template
GET/v1/send/suppressionsList suppressions
GET/v1/send/suppressions/{email}Get a suppression
POST/v1/send/suppressions/{email}/unsuppressUnsuppress an address
GET, POST/v1/send/u/{token}Hosted unsubscribe link (no API key)

Account

MethodPathDescription
GET/v1/send/tenantsSending status and trust stage

Webhooks

Webhook endpoints are managed at the platform level (https://api.do.dev/v1/webhooks). The Send API emits send.email.sent, send.email.delivered, send.email.bounced, send.email.complained, and send.email.unsubscribed. See Webhooks.

Where to start