Skip to main content
POST
Create email draft

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

inboxId
string
required

ID of the inbox that owns and sends this draft. Scoped API keys require an inbox within their scope.

Minimum string length: 1
threadId
string

Reply to this thread when the draft is sent. The draft inherits its reply subject and source thread.

Minimum string length: 1
sourceThreadId
string

Associate the draft with this conversation in its sending inbox. Omit threadId for a forward or new conversation. For replies, sourceThreadId must match threadId if both are supplied.

Minimum string length: 1
to
string<email>
Maximum string length: 320
cc
string<email>[]
Maximum array length: 100
Maximum string length: 320
bcc
string<email>[]
Maximum array length: 100
Maximum string length: 320
subject
string
Maximum string length: 998
bodyHtml
string

HTML message body. This is the only accepted body input; the plain-text fallback is generated automatically. Omit for an incomplete draft. Embedded raster images and images at public HTTP(S) URLs on standard ports are imported as attachments. Saved HTML references them by CID.

Maximum string length: 500000

Response

Saved unsent draft

Saved unsent draft

id
string
required
inboxId
string
required
to
string | null
required
cc
string[]
required
bcc
string[]
required
subject
string
required
bodyText
string | null
required
bodyHtml
string | null
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
threadId
string | null

Thread this draft will reply to when sent.

sourceThreadId
string | null

Conversation this draft was composed from.

attachments
object[]