# send_chat_message: Send a message with files or a voice note

Send a message into one conversation, with files, a voice note or a video note, or as an answer to one message. This action can change or spend something, and it happens right away. Plan: Free and Connect.

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

{
  "chatId": "PASTE_CHAT_ID_HERE",
  "text": "Hello!"
}
```

## What you give it

- `chatId` (needed): a chat id. The conversation id (from list_chats). Where to get it: Run `list_chats` and use `chats[].id`.
- `text` (optional): text, up to 8000 characters. The message text. Optional when a file or note is sent.
- `attachmentUrls` (optional): a list (a link), up to 9. Files or images to attach. Public https links; each file up to 10 MB, 20 MB in total.
- `voiceMessageUrl` (optional): a link. An audio file to send as a voice note (.m4a preferred). A public https link, up to 10 MB.
- `videoMessageUrl` (optional): a link. A video file to send as a video note. A public https link, up to 10 MB.
- `replyToMessageId` (optional): a message id. Quote and answer this message of the conversation. 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

- `sent`
- `chatId`: a chat id
- `messageId`: a message id
- `from`: the account it ran on
- `usedToday`: number
- `dailyLimit`: number

## Good to know

- Pass text, a file, a voice note or a video note: at least one.
- It sends into any conversation of yours, an InMail one too (chatId from list_inmail). It does not check whether the conversation takes replies, nor that the account is on the Sales Navigator contract the conversation was started on.

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