Skip to content
MailerOwl
Menu

Send an email

POST https://api.mailerowl.com/v1/emails

Field Type Notes
from string "Name <addr@domain>". Domain must be verified
to string[] 1+ recipients. Max 50 across to, cc and bcc
cc, bcc string[] Optional
reply_to string[] Optional
subject string Required, single line
html, text string At least one. If only html, we generate the text part
headers object Custom headers. Reserved headers (From, To, DKIM-Signature…) are rejected
tags object Up to 10 key/value tags ([A-Za-z0-9_-]), returned in events
attachments array See Attachments
marketing boolean Adds unsubscribe headers. See Marketing email
idempotency_key string See Idempotency
scheduled_at RFC 3339 Up to 30 days ahead. See Scheduling

Response

202 Accepted

{"id": "msg_0193...", "status": "queued", "test": false, "suppressed": ["bad@example.com"]}

suppressed lists recipients we skipped because they are on a suppression list. If all recipients are suppressed the call fails with 422 all_recipients_suppressed.

Errors

See Error codes.

Quotas

Each non-suppressed recipient counts as one email toward your monthly quota. Test-mode sends are free.