Create Draft
Create a draft on an inbox, either as a new conversation or as a reply.
POST
A draft is an unsent message. Omit
thread_id for a new conversation. Pass
thread_id and reply_to_email_id together to attach it as a reply. When a
reply draft is created without to, it’s filled in the same way as Reply to
Thread Email. cc, bcc, and
subject are never filled in, so set subject before you send it.
At least one of to, cc, bcc, subject, text, html, or attachments
must be non-empty. Combined recipients cannot exceed 50. Returns 201 for a
new draft, or 200 if that reply draft already exists.
Path Parameters
Body Parameters
string | string[] | null
Recipients. Each value may include a friendly name, for example
Ada Lovelace <ada@example.org>.string | string[] | null
CC recipients.
string | string[] | null
BCC recipients.
string | null
The subject. Max 2000 characters.
string | null
The HTML body.
string | null
The plain-text body.
array
Filename and content of attachments (max 25MB of content). Each file is raw
content. path and content_id return 422. An empty file returns 422.
A file counts as draft content.Response Fields
string
Always
inbox_draft.string
The ID of the draft.