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.