InMail

List InMail conversations

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

post/v1/actions/list_inmail

Request

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

Request body

connectionIdstring

Only this sender account (its linkedinConnections _id). Omit to read every live sender on the active setup.

profileUrlstring

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.

unreadOnlyboolean

Only threads with unread messages.

awaitingReplyOnlyboolean

Only threads where the other person wrote last (they are waiting on you).

searchstring

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.

limitnumber

Max threads to return (default 25, max 100).

syncInboxboolean

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

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

oktrue required
resultobject required

What was asked for. A field that does not apply is left out, or is null.

Changes

No recorded changes to this operation across all 1 revision of this API.