Submit outbound email message
Submits a raw MIME message for outbound relay, local delivery, forwarding, or webhook execution with per-recipient fan-out. Who calls it: the platform's SMTP submission gateway (system key, submitting on the authenticated user's behalf); an account key may also call it directly to submit pre-built MIME as any sender address the account owns. For structured sending prefer POST /mailboxes/{mailboxId}/send, which builds the MIME for you; this door is for callers that already have the bytes. Lone CR and LF are normalized to CRLF before parsing or delivery; the size limit applies to the normalized message.
bearerAuthAuthorizationBearer <token>Two credential kinds share this scheme; GET /api/v1/auth/whoami answers which one you hold and what it reaches.
oek_… API key (minted by POST /api/v1/api-keys; shown once at mint). role: account reaches the full account surface: the directory (domains, routes, patterns, api-keys, accounts, address lists) plus every mailbox the account owns. role: system additionally reaches the operator surface, which is documented separately.
oemp_… mailbox app password (minted by POST /api/v1/identities/{identityId}/credentials). Reaches ONE mailbox: its messages, labels, threads, search, sync, send, filters and PIM collections. Directory routes refuse it with 403 insufficient_scope.
Refusal vocabulary: a missing, malformed, expired, or revoked credential answers 401 unauthorized with a WWW-Authenticate: Bearer challenge; a VALID credential outside its scope answers 403 (insufficient_scope for an app password on a directory route, system_credentials_required where only the operator may call). The public routes (health, branding, token-in-path capabilities) declare security: [].
save?stringSave a copy to the sender's Sent folder
"true""false"bounce?stringGenerate a bounce report (DSN) to the sender if relay fails permanently (default true)
"true""false"x-delivery-id*stringCaller transaction ID and idempotency key
1 <= lengthx-envelope-from*stringSender email address (MAIL FROM)
x-envelope-to*stringRecipient email address (RCPT TO)
x-accept-held?string1 from the system key: smtp-in's submission re-post of a recipient it set aside because the recipient mailbox's receive hold refused it (policyScope: "mailbox") after another recipient of the same transaction committed. The leg is accepted and staged (202) instead of refused: a paused one is delivered once the hold clears, or reported to the sender as expired at the paced queue's deadline; a disabled one is reported at once by a delivery-status notice in the sending mailbox. Ignored from any other caller and for any other refusal.
x-source-host?stringMTA submission hostname
x-delivery-meta?stringJSON delivery metadata string (max 8 KB)
content-length*stringMIME message size in bytes
body*stringmessage/rfc822Raw RFC 5322 MIME message bytes
Message delivered to local recipient mailbox
application/json- response
duplicate*booleanTrue if message was an idempotent duplicate
messageId*stringAssigned message ULID
sentCopy?stringStatus of saved sent copy
"saved""duplicate""over_quota"sentThreadId?|Thread ID of saved sent copy
status*"delivered"Message was immediately delivered to mailbox
"delivered"threadId*|Conversation thread ULID, or null
uid*|IMAP UID in inbox, or null
int64uidValidity*|IMAP UIDVALIDITY epoch, or null
int64curl -X POST 'https://api.open.email/api/v1/deliver/outbound' \
-H 'x-delivery-id: string' \
-H 'x-envelope-from: string' \
-H 'x-envelope-to: string' \
-H 'content-length: string' \
-H 'Content-Type: message/rfc822' \
-d 'string'{
"duplicate": true,
"messageId": "string",
"sentCopy": "saved",
"sentThreadId": "string",
"status": "delivered",
"threadId": "string",
"uid": 0,
"uidValidity": 0
}Check recipient deliverability GET
Advisory RCPT-time pre-flight check. By default it is the inbound MTA's question: does the recipient exist here, and do its blocklists and routing rules accept…
Deliver inbound email message POST
Processes and delivers an inbound MIME email message to a mailbox, webhook, forwarding address, or mailing group with Sieve filter execution. Who calls it: the…