Email Drafts

Create a draft

Changed on

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

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/email_inboxes/{inbox_id}/drafts
  • Auth: HTTP bearer

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

  • 9621f6123ebcRevision changes
    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

  • b1bf96d8391eRevision changes
    • info

      endpoint added