Mailboxes

Reply to a conversation

Answer the person who last wrote in, from the mailbox's own address, inside the same thread.

You cannot name the recipient or the sender. The recipient is the sender of the latest inbound message and the sender is the mailbox in the path. This is not sendMailboxMessage: that starts a new conversation with an address you name, under mailboxes:send; this one only ever answers someone who wrote first, under a separate scope, so holding one never implies the other.

Supply either a plain-text body or a structured React Email document. Sendly renders HTML and a matching plain-text alternative.

Refusals worth handling by name:

  • 422 UNPROCESSABLE — the thread has no inbound message to answer, or the mailbox is not provisioned.
  • 422 SEND_REFUSED — the recipient is suppressed or the project may not send.
  • 429 SENDING_LIMIT_REACHED — the project's sending limit.
  • 502 JMAP_SUBMISSION_FAILED — the mail server refused the submission. Nothing was sent.

A reply cannot be recalled once sent.

No existing API key can call this. The scope is opt-in only: a key or an OAuth connection holds it only if it was ticked by name when the credential was created or approved — the legacy full-access key and the "Full access" preset do not carry it.

Requires the mailbox-conversations:reply scope — Reply to conversations in your hosted mailboxes, from the mailbox's own address.

post/api/mailboxes/{id}/conversations/{conversationId}/reply

Request

  • Base URL: https://api.sendly.now
  • URL: https://api.sendly.now/api/mailboxes/{id}/conversations/{conversationId}/reply
  • Auth: one of:
    • HTTP bearer
    • API key in cookie better-auth.session_token
    • OAuth 2 (authorization code, authorization URL https://app.sendly.now/api/auth/oauth2/authorize, token URL https://app.sendly.now/api/auth/oauth2/token, scopes: mailbox-conversations:reply)

Path parameters

idstring uuid required
conversationIdstring uuid required

Request body

bodystring

Response

Reply submitted

successtrue required

Changes

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