drafts

Create a draft

Creates a voluntary draft in status draft. Requires can_send. The draft is not forced into the approval queue at creation time even on a require_approval mailbox — forcing happens at send time. to is required unless reply_to_message_id is supplied. Note: draft creation has no client_id idempotency yet — a retried create can duplicate a draft.

post/api/v1/drafts

Request

  • Base URL: https://postfleet.ai
  • URL: https://postfleet.ai/api/v1/drafts
  • 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

Draft created.

idstring required
status'draft' required

Changes

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