v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Email Drafts

Create a draft

Creates an unsent draft in the inbox. Every field is optional — a draft is a work-in-progress and may be saved incomplete. Send-time requirements (sender, subject, at least one recipient) are enforced when the draft is sent, not when it is created.

Drafts are unbillable and emit no Email Detail Records until they are sent.

post/email_inboxes/{inbox_id}/drafts

Path parameters

inbox_idstring uuid required

Email inbox UUID.

Request body

attachmentsobject[]
from_emailstring
from_namestring
headersobject
htmlstring

Alias for html_body, matching the send endpoint.

html_bodystring
labelsstring[]
metadataobject
reply_tostring
subjectstring
tagsstring[]
textstring

Alias for text_body, matching the send endpoint.

text_bodystring

Response

The created draft.