v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Email Threads

List threads across every inbox in the account

Lists thread summaries for the whole account, newest first, using stable cursor pagination. An agent operating many inboxes gets every conversation in one call instead of one call per inbox. Each thread carries its own inbox_id so a reply can be routed back to the right inbox. Use filter[inbox_id] (repeatable) to narrow the result to specific inboxes. Because a thread ID can be delivered to multiple inboxes, each result is identified by its (inbox_id, id) pair.

get/email_threads

Query parameters

filter[inbox_id]string[]

Restrict results to one or more inboxes. Repeat the parameter (filter[inbox_id][]=...&filter[inbox_id][]=...) or pass a comma-separated list. Omit to list every inbox in the account. Inboxes outside the account are silently excluded. If the filter is present, it must contain at least one non-empty UUID.

page[size]integer

Number of results to return. Defaults to 25; maximum is 100.

page[after]string

Opaque cursor returned by the previous page.

filter[label]string

Returns only threads carrying this label. Matching is exact and case-sensitive. Thread labels are independent of the labels on the thread's messages.

Response

Paginated account-wide threads.