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

# Get a message

`POST /v1/actions/get_message`

## Request

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

Read one message.

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

## Request body

- object
  - `messageId` string, required: The message id (from list_chat_messages).
  - `connectionId` string: Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

## Response `200`

It worked. Inside result: messageId, providerId, senderId, text, attachments[].id, attachments[].fileSize, attachments[].unavailable, attachments[].mimetype, attachments[].url, attachments[].urlExpiresAt, attachments[].type, attachments[].sticker, attachments[].gif, attachments[].duration, attachments[].voiceNote, attachments[].fileName, attachments[].startsAt, attachments[].expiresAt, attachments[].timeRange, attachments[].displayName, attachments[].organization, id, chatId, chatProviderId, timestamp, isSender, quoted.messageId, quoted.providerId, quoted.senderId, quoted.text, isForwarded, isViewOnce, reactions[].value, reactions[].senderId, reactions[].isSender, seen, hidden, deleted, edited, isEvent, delivered, behavior, eventType, original, replies, replyBy, parent, senderAttendeeId, subject, messageType, attendeeType, attendeeDistance, senderUrn, replyTo.id, replyTo.providerId, replyTo.timestamp, replyTo.senderAttendeeId, replyTo.senderId, replyTo.text.

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