Mailboxes

Send a draft

Sends one of the caller's drafts: a reply draft in its thread, any other draft as a new conversation. A draft needs recipients, a subject, and a body.

post/v1/mailboxes/{id}/drafts/{draftId}/send

Request

  • Base URL: https://api.samva.dev
  • URL: https://api.samva.dev/v1/mailboxes/{id}/drafts/{draftId}/send
  • Auth: API key in header x-api-key

Path parameters

idstring required
draftIdstring 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.

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.