Sign in
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.

Changes

Changed in 2 of the 99 revisions of this API.81

  • 9621f6123ebc8See the full diff
    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

  • b1bf96d8391e1See the full diff
    • ○

      endpoint added

      endpoint-added

Of the 99 revisions, 1 has no diff computed.