Send email
Send an email from an inbox. Requires Idempotency-Key header. Use threadId to reply to an existing thread. When replying on a thread where your inbox was CC’d (deliveryRole cc), the original sender is automatically CC’d.
Every recipient this call can reach — to, cc (including any address auto-CC’d on a thread reply), and replyTo — is checked against the inbox’s outbound correspondent policy before anything is sent. A single denied recipient rejects the whole send with 403 recipient_not_permitted; there is no partial delivery.
Bcc is not supported. A request carrying a bcc field is rejected with 400 unsupported_field rather than accepted with the blind recipient dropped, so a recipient can never appear to have been addressed without being delivered to and policy-checked.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Unique key for idempotent sends (e.g. UUID)
Path Parameters
Body
Email body. Plain text or HTML — HTML is auto-detected and rendered, with a plain-text fallback generated automatically.
1 - 100000Required for new threads. Optional when threadId is set — the thread subject is used automatically (with Re: prefix).
1 - 998Provide only when the plain-text and HTML versions must differ. Omit for normal sends — put HTML in body instead.
500000Thread ID for replies
When replying with threadId, append a quoted copy of the previous message to the body. Defaults to true. Set false to send only your reply text.
Optional. Address that replies should be routed to (set as the Reply-To MIME header). Free plan: must be the address of an inbox you own in OpenMail. Pro plan or higher: any valid email address.
Optional CC recipients.