list_conversations
Read-onlyIdempotent
Social inbox DM conversations for Instagram and Facebook Page inboxes (Threads has no DMs; Pro plan or higher plus posts:read). Without conversation_id: list conversations filtered by account, platform, unread/starred/archived, or search, with limit/offset paging. With conversation_id: one conversation and its messages; there limit is the number of messages (default 50, max 100) and only workspace_id may be added.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Conversations to return, or messages with conversation_id. Default 50, max 100. | |
| filter | No | Conversation filter. Defaults to all (excludes archived). | |
| offset | No | Skip this many conversations before returning results. | |
| search | No | Search participant username or last message preview. | |
| platform | No | instagram or facebook. Threads has no DMs. | |
| account_id | No | Social account ID from list_accounts. | |
| workspace_id | No | Optional. Omit to search every workspace you belong to; pass a workspace ID from whoami to limit to one. | |
| conversation_id | No | One conversation (from a list call) with its messages. |