send

Send an email

The single outbound path for direct and MCP sends. Requires an api or mcp key with can_send. Supply an optional client_id for idempotent duplicate protection (replay table). On a mailbox with require_approval enabled, the send is turned into a forced draft (202) instead of delivering. to is required unless reply_to_message_id is supplied; to must be exactly one address (multi-recipient is rejected 400).

post/api/v1/send

Request

  • Base URL: https://postfleet.ai
  • URL: https://postfleet.ai/api/v1/send
  • Auth: HTTP bearer

Request body

mailbox_idstring required

Mailbox to send from. A mailbox-bound key must match this.

textstring required

Plain-text body.

tostring

Single recipient address. Required unless replying; must be exactly one address.

subjectstring
reply_to_message_idstring

Reply in-thread to an existing message; resolves to/subject/thread from the original.

client_idstring

Idempotency key for duplicate protection. Must not start with draft: (reserved).

Response

Idempotent replay: this client_id was already used with the same payload for a completed send; the stored result is returned verbatim.

idstring required

Stored message id.

thread_idstring required
provider_message_idstring required

Changes

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