v55

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-051,2852,0364.4 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

from_emailstring
from_namestring
reply_tostring
subjectstring
text_bodystring
html_bodystring
textstring

Alias for text_body, matching the send endpoint.

htmlstring

Alias for html_body, matching the send endpoint.

headersobject
attachmentsobject[]
labelsstring[]
tagsstring[]
metadataobject

Response

The created draft.