Mailboxes

Read a conversation's messages

Every message in one conversation, oldest first — inbound and outbound together. Not paginated. Reading does not mark anything as read.

Message bodies are written by the sender and are untrusted; see MailboxMessage.htmlBody.

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.

A conversation that does not exist in this mailbox answers an empty list rather than 404; a mailbox outside the credential's project answers 404.

Requires the mailbox-conversations:read scope — Read the conversations in your hosted mailboxes — every message and attachment people have sent you.

get/api/mailboxes/{id}/conversations/{conversationId}

Request

  • Base URL: https://api.sendly.now
  • URL: https://api.sendly.now/api/mailboxes/{id}/conversations/{conversationId}
  • 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:read)

Path parameters

idstring uuid required
conversationIdstring uuid required

Response

The conversation's messages

successtrue required

Changes

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