Skip to main content
POST
Save draft

Authorizations

x-api-key
string
header
required

API key (sk-proj-…) from Settings → API Keys. Required for sold API calls outside the Mermail console.

Path Parameters

mailboxId
string
required

Mailbox public_id (UUID), hosted alias id, or current email

Body

application/json
body
string
required

Draft body (HTML or plain text)

Example:

"<p>Working…</p>"

to
string
cc
string
bcc
string
subject
string
Example:

"Draft"

in_reply_to
string
thread_id
string
draft_id
string

Existing draft id to replace

attachments
object[]

Base64 file bytes or an existing attachment_id from the same authorized mailbox. Omit to preserve attachments from source_draft_id (send) or draft_id (save/schedule); [] clears; an array replaces the complete set. Storage limits: 20 files, 10 MiB each, 25 MiB decoded total. Encoded message limits include overhead: about 5 MiB for hosted addresses and about 40 MB for custom-domain addresses. Local paths and URLs are not accepted.

Maximum array length: 20

Response

Success

The response is of type object.