Email Drafts

Send a draft

Changed on

Sends the draft through the standard send pipeline — the same domain resolution, suppression, reputation, daily-quota, persistence and Detail Record behaviour as POST /v2/email_messages. The response body is the created email message.

If the draft has no explicit from_email, the inbox address is used.

The draft is marked sent only after the send is accepted; a send rejected for suppression, quota or reputation leaves the draft editable so it can be fixed and retried. A draft that is already sent returns 422 rather than sending twice.

post/email_inboxes/{inbox_id}/drafts/{draft_id}/send

Request

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

Path parameters

inbox_idstring uuid required

Email inbox UUID.

draft_idstring uuid required

Email draft UUID.

Response

The draft was accepted for delivery. Returns the created email message.

Example response

{
  "data": {
    "recipient_statuses": {
      "delivered": 998,
      "bounced": 2
    }
  }
}

Changes

  • 16bfa298dc71Revision changes
    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • 9621f6123ebcRevision changes
    • breaking

      added to the response body oneOf list for the response status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • warning

      removed the optional property from the response with the 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 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

    • 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