# list_inmail: List InMail conversations

List your InMail conversations, or every conversation with one person. This action only reads; it changes nothing. Plan: Free and Connect.

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

{}
```

## What you give it

- `connectionId` (optional): a connection id. Only this sender account (its linkedinConnections _id). Omit to read every live sender on the active setup. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.
- `profileUrl` (optional): a profile link or a Sales Navigator lead link. The person's LinkedIn profile URL (linkedin.com/in/…) or Sales Navigator lead URL. Returns every conversation with that one person — InMail and classic, each tagged by inbox — instead of scanning the inbox. Where to get it: Open the person's profile on LinkedIn and copy the address from your browser. It looks like https://www.linkedin.com/in/their-name Or: Run `search_people` and use `people[].profileUrl`.
- `unreadOnly` (optional): true or false. Only threads with unread messages.
- `awaitingReplyOnly` (optional): true or false. Only threads where the other person wrote last (they are waiting on you).
- `search` (optional): text. Filter by participant name, headline or latest message text. Ranked: name/headline matches first, then latest-message matches, each newest first; every row says matchedBy. To find one known person, prefer profileUrl.
- `limit` (optional): a number, 1 to 100. Max threads to return (default 25, max 100).
- `syncInbox` (optional): true or false. true = first pull the ACTIVE Sales Navigator contract's InMail inbox from LinkedIn (after a contract switch, or when threads seem missing), then read. Slower (~25s).

## What you get back

- `total`
- `inmail`
- `note`

## Good to know

- With profileUrl it returns every conversation with that person, InMail or not, each tagged by inbox.
- Sales Navigator shows only the active contract's inbox. After switch_sales_navigator_contract, or when conversations seem missing, pass syncInbox true.
- canReply false means LinkedIn will not accept a reply in that conversation.
- Reply with send_chat_message and the row's chatId. It does not check the Sales Navigator contract: when sentFromContract is not the account's active contract (list_sales_navigator_contracts), switch to it first with switch_sales_navigator_contract, or the reply may not reach the conversation.

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