Docs / InMail

`get_inmail_conversation`

Read one InMail conversation.

This action only reads. It changes nothing, so it is safe to try.

What you give it

Input	What it is	Where to get it
`chatId` needed	A chat id. The chatId from list_inmail.	Run `list_chats` and use `chats[].id` from its answer. 12 more places to get it `list_messages` → `messages[].chatId` `list_inmail` → `inmail[].chatId` `get_conversation` → `chatId` `get_chat` → `id` `list_chat_messages` → `messages[].chatId` `get_message` → `chatId` `list_attendee_chats` → `chats[].id` `list_attendee_messages` → `messages[].chatId` `send_message` → `conversationId` `send_chat_message` → `chatId` `start_conversation` → `chatId` `get_inmail_conversation` → `chatId`
`connectionId` optional	A connection id. The sender account that owns this thread (optional).	Run `list_linkedin_accounts` and use `accounts[].id` from its answer. 15 more places to get it `get_my_profile` → `accounts[].connectionId` `list_connections` → `connections[].connectionId` `list_connections` → `summary.accounts[].connectionId` `list_sent_invitations` → `pendingInvitations[].connectionId` `preview_withdraw_invitations` → `breakdown[].linkedinConnectionId` `list_conversations` → `inbox[].linkedinConnectionId` `list_inmail` → `inmail[].connectionId` `get_inmail_credits` → `accounts[].connectionId` `list_sales_navigator_contracts` → `accounts[].connectionId` `who_is_waiting_on_me` → `waitingOnYou[].connectionId` `who_went_cold` → `coldConversations[].connectionId` `connections_never_messaged` → `summary.accounts[].connectionId` `get_usage` → `connectionId` `get_conversation` → `connectionId` `get_inmail_conversation` → `connectionId`
`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.	You write it.

Call it

curl -X POST https://api.heyreagent.com/v1/actions/get_inmail_conversation \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{"chatId":"PASTE_CHAT_ID_HERE"}'

The same call in JavaScript

const response = await fetch("https://api.heyreagent.com/v1/actions/get_inmail_conversation", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_KEY",
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "chatId": "PASTE_CHAT_ID_HERE"
  }),
});
const answer = await response.json();
console.log(answer);

The same call in Python

import requests

response = requests.post(
    "https://api.heyreagent.com/v1/actions/get_inmail_conversation",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={
        "chatId": "PASTE_CHAT_ID_HERE",
    },
)
print(response.json())

The same call in n8n

Add an HTTP Request node and fill it in like this:

Method	`POST`
URL	`https://api.heyreagent.com/v1/actions/get_inmail_conversation`
Send Headers	On. Name `Authorization`, Value `Bearer YOUR_KEY`
Send Body	On. Body Content Type `JSON`, Specify Body `Using JSON`, then paste the body below

{
  "chatId": "PASTE_CHAT_ID_HERE"
}

Put your own key where it says YOUR_KEY. Put your own value where it says PASTE_…_HERE: the table above says where each one comes from. New here? Start with your first call.

What you get back

When it worked, the answer is { "ok": true, "result": { … } }. Inside result:

`chatId`	A chat id. Other actions take it.
`connectionId`	A connection id. Other actions take it.
`connectionLabel`
`inbox`
`isInMail`
`subject`
`participant`
`canReply`
`awaitingYourReply`
`sentFromContract`	A contract id. Other actions take it.
`messageCount`
`messages`

A field that does not apply to an answer is left out, or is null.

When it did not work, the answer is { "ok": false, "error": "…", "message": "…" }. What each error means.

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.

In Claude or ChatGPT

Once connected, ask in your own words. The assistant sees this action as a tool with the same name, get_inmail_conversation, and the same inputs.