send

Compose and send a fresh email from a mailbox you own

Single recipient. Runs the full governance pipeline: ownership, the mailbox's policy blocklist, its operating mode (shadow mode refuses), and the account's tier send caps. Only a send that actually leaves consumes quota.

post/v1/mailboxes/{mailbox_id}/send

Request

  • Base URL: https://mbag.ai/api
  • URL: https://mbag.ai/api/v1/mailboxes/{mailbox_id}/send
  • Auth: HTTP bearer

Path parameters

mailbox_idinteger required

Request body

html_bodystring

Optional HTML part alongside the plain text.

subjectstring required
text_bodystring required
tostring required

Exactly one recipient email address.

Response

Sent.

message_idstring required

JMAP id of the created message

status'sent' required

Changes

No recorded changes to this operation across all 1 revision of this API.