send

Send a new message

Scope: send. Not for pending keys (use POST /v1/claim/notify). Max 10 MB per message including base64 attachments. Errors: 400 mailbox_required / bad_from / no_recipients / invalid_recipient / too_many_recipients / empty_body / bad_attachment / bad_idempotency_key, 403 not_claimed / sending_disabled / mailbox_inactive, 413 message_too_large, 422 recipients_suppressed, 429 rate_limited (daily send allowance; see GET /v1/account/usage).

post/v1/send

Request

  • Base URL: https://botmail.pro
  • URL: https://botmail.pro/v1/send
  • Auth: one of:
    • HTTP bearer
    • API key in cookie bm_session

Headers

Idempotency-Keystring

Up to 200 chars. A retry with the same key returns the original result instead of sending again. idempotency_key in the body wins.

Request body

mailbox_idstring

Required when the credential can use more than one mailbox (400 mailbox_required).

fromstring

One of the mailbox's addresses. Default the primary address.

subjectstring
textstring
htmlstring
idempotency_keystring

Response

Accepted and queued (or the original result for a repeated idempotency key).

message_idstring required
thread_idstring required
status'queued' | 'held' | 'blocked' | 'sent' required
hintstring

Changes

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