# get_message: Get a message

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

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

{
  "messageId": "PASTE_MESSAGE_ID_HERE"
}
```

## What you give it

- `messageId` (needed): a message id. The message id (from list_chat_messages). Where to get it: Run `list_chat_messages` and use `messages[].id`.
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `messageId`: string
- `providerId`: string
- `senderId`: a member id
- `text`: string or null
- `attachments[].id`: a attachment id
- `attachments[].fileSize`: number
- `attachments[].unavailable`: boolean
- `attachments[].mimetype`: string
- `attachments[].url`: string
- `attachments[].urlExpiresAt`: number
- `attachments[].type`: poll
- `attachments[].sticker`: boolean
- `attachments[].gif`: boolean
- `attachments[].duration`: number
- `attachments[].voiceNote`: boolean
- `attachments[].fileName`: string
- `attachments[].startsAt`: number or null
- `attachments[].expiresAt`: number or null
- `attachments[].timeRange`: number or null
- `attachments[].displayName`: string or null
- `attachments[].organization`: string or null
- `id`: a message id
- `chatId`: a chat id
- `chatProviderId`: string
- `timestamp`: string
- `isSender`: 0 | 1
- `quoted.messageId`: string
- `quoted.providerId`: string
- `quoted.senderId`: string
- `quoted.text`: string or null
- `isForwarded`: boolean
- `isViewOnce`: boolean
- `reactions[].value`: string
- `reactions[].senderId`: string
- `reactions[].isSender`: boolean
- `seen`: 0 | 1
- `hidden`: 0 | 1
- `deleted`: 0 | 1
- `edited`: 0 | 1
- `isEvent`: 0 | 1
- `delivered`: 0 | 1
- `behavior`: 0 or null
- `eventType`: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14
- `original`: string
- `replies`: number
- `replyBy`: string[]
- `parent`: string
- `senderAttendeeId`: a attendee id
- `subject`: string or null
- `messageType`: MESSAGE | INVITATION | INMAIL | INMAIL_DECLINE | INMAIL_REPLY | INMAIL_ACCEPT | STORY_MENTION | STORY_REPLY | CONTACT
- `attendeeType`: MEMBER | ORGANIZATION | OTHER
- `attendeeDistance`: 1 | 2 | 3 | 4 | -1
- `senderUrn`: string
- `replyTo.id`: string
- `replyTo.providerId`: string
- `replyTo.timestamp`: string
- `replyTo.senderAttendeeId`: string
- `replyTo.senderId`: string
- `replyTo.text`: string or null

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