Inboxes

Create a draft

Create a draft for a person to review and send. Nothing is sent, so it needs only the inbound:read scope: give an agent a key without email:send and every message it writes waits here for approval. Omit thread_id for a new conversation; send thread_id and reply_to_email_id together for a reply (recipients are not copied, set to before sending). At least one of to, cc, bcc, subject, text or html must be non-empty; 50 recipients at most; subject up to 900 characters (Resend allows 2000; a longer subject could never be sent here). Returns 201 for a new draft, or 200 when an unsent reply draft for that message already exists, updated with the fields sent.

post/v1/inboxes/{inbox_id}/drafts

Request

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

Path parameters

inbox_idstring required

The inbox id or its email address

Request body

subjectstring nullable
htmlstring nullable
textstring nullable
thread_idstring

The thread to reply in. Send with reply_to_email_id.

reply_to_email_idstring

The message to reply to. Send with thread_id.

Response

The existing reply draft, updated

objectstring
idstring
type'standalone' | 'reply'
tostring[] nullable
ccstring[]
bccstring[]
subjectstring nullable
htmlstring nullable
textstring nullable
thread_idstring nullable
reply_to_email_idstring nullable
email_idstring nullable

The queued email once sent

created_atstring date-time
updated_atstring date-time
created_via'api' | 'dashboard'

Who wrote the draft. Not in Resend.

sent_atstring date-time nullable

Not in Resend

revisioninteger

Goes up with every edit. Pass it to send or update to act only on this version. Not in Resend.

thread_subjectstring nullable

The subject of the thread a reply draft answers. Not in Resend.

Example response

{
  "object": "inbox_draft"
}

Changes

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