---
title: "List InMail conversations"
method: POST
path: "/v1/actions/list_inmail"
tags: ["InMail"]
---

# List InMail conversations

`POST /v1/actions/list_inmail`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/list_inmail`
- Auth: HTTP bearer

List your InMail conversations, or every conversation with one person.

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.

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

## Request body

- object
  - `connectionId` string: Only this sender account (its linkedinConnections _id). Omit to read every live sender on the active setup.
  - `profileUrl` string: 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.
  - `unreadOnly` boolean: Only threads with unread messages.
  - `awaitingReplyOnly` boolean: Only threads where the other person wrote last (they are waiting on you).
  - `search` string: 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` number: Max threads to return (default 25, max 100).
  - `syncInbox` boolean: 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).

## Response `200`

It worked. Inside result: total, inmail, note.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)