List inbox threads
Returns chat threads across WhatsApp, Messenger, Instagram and web chat, most recent activity first. Filter by channel, status, assignee (a user id or unassigned), handled_by, unread, q and agent_id. Page with limit and cursor.
Scopes: inbox:read
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Query Parameters
whatsapp, messenger, instagram, web open, done, snoozed me | unassigned | a user id
64agent, human 80641 <= x <= 100512Response
Successful Response
The items on this page, in the list's order.
True when another page follows this one.
Totals across the whole inbox, beside the page.
Pass as cursor to get the next page. Null on the last page. Opaque: don't parse it.