List a mailbox's conversations
The threads in one mailbox, newest activity first, from the Inbox view or the Spam view.
This is correspondence from people outside your project, who wrote to your address without ever dealing with Sendly. That is why it has a scope of its own and is not covered by mailboxes:read, which is the mailbox's settings and never its contents.
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.
Pages through nextCursor: pass it back as cursor until it is null. The mailbox must belong to the project the credential resolves to; one in another project answers 404.
Requires the mailbox-conversations:read scope — Read the conversations in your hosted mailboxes — every message and attachment people have sent you.
Request
- Base URL: https://api.sendly.now
- URL: https://api.sendly.now/api/mailboxes/{id}/conversations
- 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
Query parameters
Default inbox.
Default all.
Case-insensitive substring match on the subject or the correspondent's address.
The nextCursor of the previous page.
Page size. Default 30, at most 50.
Response
A page of conversations
Changes
No recorded changes to this operation across all 1 revision of this API.