# get_inmail_conversation: Get an InMail conversation

Read one InMail conversation. This action only reads; it changes nothing. Plan: Free and Connect.

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

{
  "chatId": "PASTE_CHAT_ID_HERE"
}
```

## What you give it

- `chatId` (needed): a chat id. The chatId from list_inmail. Where to get it: Run `list_chats` and use `chats[].id`.
- `connectionId` (optional): a connection id. The sender account that owns this thread (optional). Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.
- `refresh` (optional): true or false. 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.

## What you get back

- `chatId`: a chat id
- `connectionId`: a connection id
- `connectionLabel`
- `inbox`
- `isInMail`
- `subject`
- `participant`
- `canReply`
- `awaitingYourReply`
- `sentFromContract`: a contract id
- `messageCount`
- `messages`

## Good to know

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

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