Conversations / MCP

List conversations

List LinkedIn (and WhatsApp) conversations for the workspace, with optional account/search/tag/reply filters and cursor pagination.

tools/callDeterministic operation

Parameters

workspaceIdOptional · string
Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
accountIdsOptional · string
Comma-separated LinkedIn account IDs to scope to. Omit for all accounts.
channelOptional · string
'linkedin' or 'whatsapp'. Omit for all channels.
searchOptional · string
Free-text search over conversations.
tagFilterOptional · string
Filter by conversation tag.
replyFilterOptional · string
Filter by reply state.awaiting_reply · need_to_reply
limitOptional · number
Max conversations (1-250, default 100).
cursorOptional · string
Pagination cursor from a previous page.
Request example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list-conversations",
    "arguments": {}
  }
}
Full input schema
Input schema
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "minLength": 1,
      "description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
    },
    "accountIds": {
      "type": "string",
      "description": "Comma-separated LinkedIn account IDs to scope to. Omit for all accounts."
    },
    "channel": {
      "type": "string",
      "description": "'linkedin' or 'whatsapp'. Omit for all channels."
    },
    "search": {
      "type": "string",
      "description": "Free-text search over conversations."
    },
    "tagFilter": {
      "type": "string",
      "description": "Filter by conversation tag."
    },
    "replyFilter": {
      "type": "string",
      "enum": [
        "awaiting_reply",
        "need_to_reply"
      ],
      "description": "Filter by reply state."
    },
    "limit": {
      "type": "number",
      "description": "Max conversations (1-250, default 100)."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from a previous page."
    }
  }
}
See this operation inCLI REST API TypeScript SDK
MCP reference | Pipeline v2 preview