# list_conversations: List conversations

List the conversations in the stored copy of your inbox, across your accounts. This action only reads; it changes nothing. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/list_conversations
Authorization: Bearer YOUR_KEY
content-type: application/json

{}
```

## What you give it

- `search` (optional): text. Search by participant, headline, message, or connection label.
- `unreadOnly` (optional): true or false. Only return unread conversations.
- `includeThreads` (optional): true or false. Attach the full message history (oldest→newest) to each conversation row under `thread`, resolved server-side — not just the latest message. Use this to read a specific conversation by searching the lead name.
- `limit` (optional): a number, 1 to 200. Max conversations to return (default 50, max 200).
- `page` (optional): a number. Page number (default 1).

## What you get back

- `total`
- `page`
- `limit`
- `totalPages`
- `hasMore`
- `lastFetchedAt`
- `syncInProgress`
- `inbox`

## Good to know

- It reads what sync_inbox last stored, not LinkedIn itself; lastFetchedAt says how old that is. list_chats reads LinkedIn live.
- To read or re-sync a row, pass its conversationUrl. To reply, pass its participantProfileUrl to send_message; that reaches a 1st-degree connection. For an InMail conversation, take the chatId from list_inmail and use send_chat_message.
- readKey changes whenever the conversation's latest message changes: take it from a fresh call.
- inbox[].headline comes back empty for the rows an inbox sync writes; the headline is in inbox[].raw.participantHeadline.
- Pages are by page number, not by cursor.

Page: https://heyreagent.com/docs/actions/list_conversations