---
title: "Get an InMail conversation"
method: POST
path: "/v1/actions/get_inmail_conversation"
tags: ["InMail"]
---

# Get an InMail conversation

`POST /v1/actions/get_inmail_conversation`

## Request

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

Read one InMail conversation.

sentFromContract is present only on a Sales Navigator conversation this app started.

Reply with send_chat_message and this chatId; canReply false means LinkedIn will not take it.

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

## Request body

- object
  - `chatId` string, required: The chatId from list_inmail.
  - `connectionId` string: The sender account that owns this thread (optional).
  - `refresh` boolean: true = first re-sync this conversation from LinkedIn, then read (slower, up to ~25s). Use when messages you know were sent — e.g. from the LinkedIn or Sales Navigator UI — are missing. The result's refresh field reports how the re-sync went.

## Response `200`

It worked. Inside result: chatId, connectionId, connectionLabel, inbox, isInMail, subject, participant, canReply, awaitingYourReply, sentFromContract, messageCount, messages.

- 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)