/v1/comms/conversationsList conversations
The inbox: every conversation the person may see, with its participants and latest activity. Start here for anything about messages, replies or who last wrote. Narrow by record: name the page with definitionKey (its key, like "leads") or definitionId (its uuid), then rowId for one record, rowId repeated for several, or no rowId for EVERY record on the page — "all my leads", "the whole board", "these five records" are ONE call, never one per record; each conversation's records says which row it belongs to. A rowId with no page is refused. Add messages=N (up to 20) to get each conversation's newest N messages, oldest first, in the same answer — read what was said across a whole board without opening each thread. lastWord keeps the conversations whose newest message is from one side — lastWord=replied (they wrote last) or lastWord=sent (we did) — and a repeated bound on when it was written, in the rows route's $created shapes: lastWord=sent&lastWord=<2026-10-15 is every thread we wrote to last before the 15th that nobody answered. summary=true caps each conversation's records at five, with record_count saying how many it has.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Responses
the action's answer
{
"conversations": [
{
"account_identifier": "string",
"contact_identifier": "string",
"contact_name": "string",
"contact_role": "string",
"created_at": "2026-01-01T00:00:00Z",
"id": 1.5,
"is_archived": true,
"is_muted": true,
"is_pinned": true,
"is_starred": true,
"labels": [
"string"
],
"last_message_at": "string",
"last_message_direction": "string",
"last_message_preview": "string",
"medium": "string",
"messages": [
"string"
],
"ownerAccountId": "",
"record_count": 1,
"records": [
{
"definition_id": "",
"definition_key": "string",
"linked_at": "string",
"name": "string",
"row_id": "",
"status": "string",
"status_label": "string",
"status_tone": "string"
}
],
"unread_count": 1.5,
"visibility": "string"
}
],
"total": 1.5
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}