GET
cURL
Lists conversations, newest first. Page through them by passing the next_cursor from one response as cursor on the next request; next_cursor is null on the last page. A conversation that arrives while you page lands on the first page and never shifts the pages after it.
Needs an API key with full access. A mailbox outside the key’s team or domain returns 404.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

mailbox
string
Required string length: 1 - 64
Pattern: ^[A-Za-z0-9_-]+$
folder
enum<string>
Available options:
inbox,
sent,
drafts,
spam,
archive,
trash
cursor
string
Required string length: 1 - 200
limit
string

1 to 50, default 20; larger values are clamped

Pattern: ^\d{1,6}$

Response

200 - application/json

Threads, newest first. A thread matches a folder when it holds at least one non-draft message there.

data
object[]
required
next_cursor
string | null
required