Skip to content

Send contract ​

POST /api/v1/email/send

Mail accepts the message for delivery it owns. Response shape:

json
{
  "emailId": "11111111-1111-1111-1111-111111111111",
  "status": "accepted",
  "message": "..."
}
HTTPstatusMeaning
200sentSMTP succeeded immediately
202acceptedPersisted; Mail will retry / deliver
202scheduledPersisted for later send

Do not re-send when status is sent, accepted, or scheduled. Orchestrators (Flow) and Client SDKs treat all three as success.

Request fields include to, cc, bcc, subject, body, isHtml, optional attachments, optional scheduledFor. Exact schemas: live OpenAPI in Development.

Roles allowed to send: Admin or Sender (Bearer or API key).

Render · Mail · Flow