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
AI Template Studio
Connect ChatGPT or Claude through MCP and save responsive, fully editable email templates.
Send an email
POST /v1/emails — a single message, a batch, or one template to many recipients.
Verify a domain
BYODKIM signing + custom MAIL FROM, with the exact DNS records to publish.
Subscribers
Create and manage contacts, tags, and topic subscriptions.
Webhooks
Receive svix-compatible, signed delivery / open / click / bounce events.
Broadcasts
One-to-many marketing sends across an audience.
Workflows
Automate multi-step journeys triggered by events.
Built for reliability
- Idempotency — pass an optional
Idempotency-Keyon email send endpoints. Reuse it when retrying the same request within 24 hours; see Idempotency. - Consistent API errors —
/v1resource 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.