Messages

Send a message

Starts a new thread. Inboxes with send_policy: approval return a draft (202) instead.

post/v1/inboxes/{inbox_id}/messages

Request

  • Base URL: https://api.send0.dev
  • URL: https://api.send0.dev/v1/inboxes/{inbox_id}/messages
  • Auth: HTTP bearer

Path parameters

inbox_idstring required

Inbox id (ibx_…)

Headers

Idempotency-Keystring

Retry-safe POSTs: same key + same body returns the stored response for 24 hours.

Request body

subjectstring required
textstring
htmlstring

Response

Message

object'message' required
idstring required
inbox_idstring required
thread_idstring required
direction'in' | 'out' required
status'received' | 'queued' | 'sent' | 'delivered' | 'bounced' | 'complained' | 'failed' required
expiredboolean required

true once the inbox's retention period has passed: text, html, extracted_text, extracted and attachments are gone (null or empty) and the raw message can't be downloaded. Addresses, subject, status and timestamps remain until the message is deleted, 35 days after it was created.

rfc_message_idstring nullable required
in_reply_tostring[] required
referencesstring[] required
subjectstring required
textstring nullable required
htmlstring nullable

Only on single-message reads and threads with include_html=true

extracted_textstring nullable required

New text only: quoted history, forwards and signatures removed

tagstring nullable required

Plus-address tag, e.g. task42 for bot+task42@

sizeinteger required
sent_atstring date-time nullable required
received_atstring date-time nullable required
created_atstring date-time required

Changes

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