List conversations
Lists the workspace’s conversations, most recently active first, with cursor pagination. Filter by status, channel, assigned agent, or contact, and search with q the same way console search works (subject, customer name/email, and message bodies).
Authorizations
Workspace API token created in Settings → API. Tokens start with adraa_.
Query Parameters
open — not closed; closed; unassigned — open and without an assigned agent; all — everything.
open, closed, unassigned, all Only conversations on this channel.
web, whatsapp, facebook, telegram, sms, email Only conversations assigned to this agent (list agents with GET /api/v1/agents).
"cmbxgwq1e0000ph01i0j1k2l3"
Only this contact's conversations (list contacts with GET /api/v1/contacts).
"cmbxgy7kq0002ph01u2v3w4x5"
Search term. Matches the subject, the contact's name and email, and message bodies.
160"refund"
The nextCursor from the previous page. Omit for the first page.
Conversations per page.
1 <= x <= 100updated (default) orders by last activity — the inbox order. created orders newest-first by creation, for polling new conversations (e.g. Zapier dedupes by the stable id).
updated, created