POpoststack
Inbound emails

Reply (threaded)

Changed on

Sends through the normal send pipeline with In-Reply-To/References set, under the calling API key exactly as POST /emails does (an sk_test_ key stays in test mode; a domain-restricted key can only send from its domain, and only reply to mail its domain received), so the same 403/422/429 conditions apply. Needs mailboxes:manage as well as email:send, since it reads the inbound message. The original is quoted under the reply unless quote_original is false, and a from that is one of your mailboxes adds its signature between the reply and the quote and saves a copy to its Sent folder.

post/inbound/{id}/reply

Request

Path parameters

idinteger required

Inbound email numeric id.

Request body

fromstring required
htmlstring
textstring
ccstring[]
bccstring[]
quote_originalboolean

Response

Queued.

idstring required

Public email id (em_…). Every email endpoint is addressed by this id.

replayedboolean

Present and true when idempotency_key (or the Idempotency-Key header) matched an earlier send: id is that email and nothing was sent. The response also carries X-Idempotent-Replay: true.

test_modetrue

Present only when authenticated with an sk_test_ key: the email was recorded and marked delivered but never handed to a mail server.

spam_scorenumber

rspamd score of the rendered message (omitted when the spam check was skipped).

Example response

{
  "id": "em_8c1f3a2b9d4e5f60718293a4"
}

Changes

  • 0d3971e3a670Revision changes
    • warning

      the / request property's maxLength was set to 320

    • warning

      the / request property's maxLength was set to 320

    • warning

      the request property's maxLength was set to 998

  • 542ca913158cRevision changes
    • info

      added the new optional request property