---
title: "Send a message with files or a voice note"
method: POST
path: "/v1/actions/send_chat_message"
tags: ["Messages"]
---

# Send a message with files or a voice note

`POST /v1/actions/send_chat_message`

## Request

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

Send a message into one conversation, with files, a voice note or a video note, or as an answer to one message.

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.

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

## Request body

- object
  - `chatId` string, required: The conversation id (from list_chats).
  - `text` string: The message text. Optional when a file or note is sent.
  - `attachmentUrls` string[]: Files or images to attach. Public https links; each file up to 10 MB, 20 MB in total.
  - `voiceMessageUrl` string, uri: An audio file to send as a voice note (.m4a preferred). A public https link, up to 10 MB.
  - `videoMessageUrl` string, uri: A video file to send as a video note. A public https link, up to 10 MB.
  - `replyToMessageId` string: Quote and answer this message of the conversation.
  - `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: sent, chatId, messageId, from, usedToday, dailyLimit.

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