---
title: "Get a conversation"
method: POST
path: "/v1/actions/get_conversation"
tags: ["Messages"]
---

# Get a conversation

`POST /v1/actions/get_conversation`

## Request

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

Read your whole conversation with one person.

chatId and participant come back only when source is "live". An answer from the stored copy (source "cache") has neither; refresh true forces a live read.

A linkedin.com/messaging/thread/… link works only for a stored conversation. For a live read pass the person's profile link.

For an InMail, Sales Navigator or Recruiter conversation the answer adds replyWith with the chatId: reply there with send_chat_message. send_message by profile link would start an ordinary conversation instead.

exists false with uncertain true means it could not be checked, not that there is no conversation.

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

## Request body

- object
  - `conversationUrl` string, required: The other person's LinkedIn profile URL (https://linkedin.com/in/…) — preferred — or a /messaging/thread/ URL.
  - `connectionId` string: Which of your senders owns this conversation (its linkedinConnections _id). Omit to search your live senders; for a live fetch the first live sender is used.
  - `refresh` boolean: true = fetch live from LinkedIn even if cached. false (default) = return the cached thread when available, else fetch live.

## Response `200`

It worked. Inside result: source, connectionId, exists, participant, chatId, inbox, messageCount, messages, 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)