List conversations
list_conversationsUse this when the user wants to see recent email threads or LinkedIn chats, such as the replies to a campaign. channel is required: email lists the threads of the organization's mailboxes, linkedin the chats of its seats, newest first. Narrow them by folder, campaign, dates and search; an email list also by mailbox and repliesOnly, a LinkedIn list by accountId. For the next page, send the page's next cursor with the same filters. Free. It lists conversations with their latest message, not every message.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"channel": "<channel>"
},
"name": "list_conversations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only conversations with a message at or before this ISO 8601 date-time, not before `since`. | |
| since | No | Only conversations with a message at or after this ISO 8601 date-time. | |
| cursor | No | The `pagination.nextCursor` of the page before. Later pages keep the first page's size. | |
| folder | No | Email: `inbox` (the default), `sent`, `unread`, `favorite`, `archived`, `spam` or `trash`. LinkedIn: `inbox` (the default, every chat) or `unread`. | |
| search | No | Email: matches names, addresses, the subject and the text. LinkedIn: matches the other person's name. | |
| channel | Yes | `email` or `linkedin`. | |
| mailbox | No | Email only: one mailbox, or up to 20 separated by commas. | |
| pageSize | No | Conversations per page. | |
| accountId | No | LinkedIn only: one seat, by its `id`. | |
| campaignId | No | Only the conversations of one campaign. | |
| repliesOnly | No | Email only: true keeps the conversations where the other side wrote back. |