Sign in
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.

Changes

Changed in 2 of the 99 revisions of this API.81

  • 9621f6123ebc8See the full diff
    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

  • b1bf96d8391e1See the full diff
    • ○

      endpoint added

      endpoint-added

Of the 99 revisions, 1 has no diff computed.