SendMailOS

SendMailOS

The email platform for developers — send transactional and marketing email with high deliverability, one clean API.

SendMailOS is a developer-first email platform. One API sends transactional and marketing email, manages subscribers, verifies sending domains, and drives automated workflows — with delivery, opens, clicks, and bounces streamed back to you in real time.

Base URL & authentication

Authenticated API requests go to https://api.sendmailos.com/v1 and carry a Bearer token: a dashboard-issued API key (sk_live_… for live sends or TEST_KEY_… for simulated sends) or an OAuth access token (oat_…, scoped to the user's grant). Some routes require a particular credential type. Test and domain-restricted keys also have route restrictions; see Authentication. Health endpoints and the OAuth token exchange have their own authentication rules.

curl https://api.sendmailos.com/v1/emails \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "from": "You <[email protected]>",
    "to": "[email protected]",
    "subject": "Welcome to SendMailOS",
    "html": "<h1>You are in.</h1>"
  }'

A 202 Accepted send returns the email's id, current status, a human-readable message, and any warnings. Acceptance means the request was queued or scheduled; it does not confirm delivery. Reads, events, and cancellation live under the same /v1/emails resource.

Everything at a glance

Built for reliability

  • Idempotency — pass an optional Idempotency-Key on email send endpoints. Reuse it when retrying the same request within 24 hours; see Idempotency.
  • Consistent API errors — /v1 resource errors use { request_id, error: { code, message, retryable, details? } }. The OAuth token exchange uses OAuth's { error, error_description } format. See Responses and errors.
  • High deliverability — BYODKIM, custom Return-Path, and warmed sending pools keep you out of spam.

Pick a resource from the sidebar to see its full reference — parameters, request and response schemas, and copy-paste code samples in curl, Node, and Python.

On this page