Inboxes

Send a draft

Sends real email: the approval step for a draft. It goes out from the inbox address through the normal send path; a reply draft joins its thread with threading headers, a new conversation starts a thread in sent. The draft needs a recipient and a body (and a subject when it is not a reply). The send claims the draft on the version it read, so an edit cannot slip in while it runs. Not in Resend: pass the revision a person reviewed; if the draft changed since, nothing is sent and the answer is 409 with code draft_changed. Without a body this is Resend's call. Sending the same draft twice queues one email; a draft that was already sent returns 409. Requires the inbound:read and email:send scopes.

post/v1/inboxes/{inbox_id}/drafts/{draft_id}/send

Request

  • Base URL: https://smtpfa.st/api
  • URL: https://smtpfa.st/api/v1/inboxes/{inbox_id}/drafts/{draft_id}/send
  • Auth: HTTP bearer

Path parameters

inbox_idstring required

The inbox id or its email address

draft_idstring required

The draft id

Request body

revisioninteger

Send only if the draft is still at this revision, the one that was reviewed. Not in Resend.

Response

Sent

objectstring
idstring
thread_idstring
email_idstring
sent_revisioninteger

Present with warning: the revision that went out. Not in Resend.

warningstring

Present when the email went out but the draft changed or was claimed again while the send ran, so it was not marked sent. Not in Resend.

Example response

{
  "object": "inbox_draft"
}

Changes

No recorded changes to this operation across all 1 revision of this API.