Mailboxes

Reply to a message

Replies to the message's Reply-To address, or its sender, in the same thread and from the thread's endpoint. The server sets the recipients, subject, and threading headers. The body's channel must match the thread's. On a phone channel the reply goes to the number on the other side of the thread.

post/v1/mailboxes/{id}/messages/{messageId}/reply

Request

  • Base URL: https://api.samva.dev
  • URL: https://api.samva.dev/v1/mailboxes/{id}/messages/{messageId}/reply
  • Auth: API key in header x-api-key

Path parameters

idstring required
messageIdstring required

Headers

idempotency-keystring nullable

Optional key that makes a mailbox send idempotent for the calling key or member. Repeating the request with the same key and body returns the original action in its current state. Keep the key after a lost response. Reusing it with different content returns 409. Active actions retain their key; terminal receipts remain replayable for 24 hours.

Request body

channel'email' nullable
ccstring[] nullable
bccstring[] nullable
textstring nullable
htmlstring nullable

Response

MailboxSendReceipt

actionIdstring required
draftIdstring required
messageIdstring required
threadIdstring required
state'approvalRequired' | 'queued' | 'accepted' | 'completed' | 'notSent' | 'uncertain' required
acceptedAtstring nullable required
waitReason'rate' | 'daily-quota' | 'domain-health' | 'sending-paused' | 'upstream-unavailable' | 'retry' | 'campaign-paused' | 'domain-warming' | 'onboarding-review' | 'content-review' | 'screening-unavailable' nullable required
reviewExpectedAtstring nullable required
executeUntilstring nullable required
retryAtstring nullable required
retryEligibleboolean required
createdAtstring required
updatedAtstring required

Changes

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