Email Drafts

Create a reply draft

Changed on

Creates an unsent reply draft for an inbound message. Unlike the /actions/reply endpoint, which sends immediately, this stores a draft that can be reviewed and edited before sending.

reply_to_message_id and thread_id are inherited from the parent message and cannot be set by the caller. The recipient, Re: subject and In-Reply-To/References headers are pre-filled from the parent using the same rules as a live reply, so sending the draft threads identically. Supplying to or subject explicitly overrides the pre-filled value.

post/email_inboxes/{inbox_id}/messages/{message_id}/drafts

Request

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

Path parameters

inbox_idstring uuid required

Email inbox UUID.

message_idstring uuid required

Inbound message UUID to reply to.

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 reply draft.

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

    • info

      endpoint added