Docs / Messages
send_message
Send one message to a 1st-degree connection, or into an existing conversation, now.
This action can change or spend something, and when it does it happens right away. Read “Good to know” first.
What you give it
| Input | What it is | Where to get it |
|---|---|---|
textneeded | Text, up to 8000 characters. The message text. | You write it. |
profileUrloptional | A profile link. LinkedIn profile URL of the 1st-degree connection to message. | Open the person's profile on LinkedIn and copy the address from your browser. It looks like https://www.linkedin.com/in/their-name Or run search_people and use people[].profileUrl from its answer.29 more places to get it
|
conversationIdoptional | A chat id. Id of an existing conversation to send into, instead of a profile URL. | Run list_chats and use chats[].id from its answer.12 more places to get it
|
connectionIdoptional | A connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. | Run list_linkedin_accounts and use accounts[].id from its answer.15 more places to get it
|
Call it
curl -X POST https://api.heyreagent.com/v1/actions/send_message \
-H "Authorization: Bearer YOUR_KEY" \
-H "content-type: application/json" \
-d '{"profileUrl":"PASTE_PROFILE_LINK_HERE","text":"Hello!"}'The same call in JavaScript
const response = await fetch("https://api.heyreagent.com/v1/actions/send_message", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_KEY",
"content-type": "application/json",
},
body: JSON.stringify({
"profileUrl": "PASTE_PROFILE_LINK_HERE",
"text": "Hello!"
}),
});
const answer = await response.json();
console.log(answer);The same call in Python
import requests
response = requests.post(
"https://api.heyreagent.com/v1/actions/send_message",
headers={"Authorization": "Bearer YOUR_KEY"},
json={
"profileUrl": "PASTE_PROFILE_LINK_HERE",
"text": "Hello!",
},
)
print(response.json())The same call in n8n
Add an HTTP Request node and fill it in like this:
| Method | POST |
| URL | https://api.heyreagent.com/v1/actions/send_message |
| Send Headers | On. Name Authorization, Value Bearer YOUR_KEY |
| Send Body | On. Body Content Type JSON, Specify Body Using JSON, then paste the body below |
{
"profileUrl": "PASTE_PROFILE_LINK_HERE",
"text": "Hello!"
}Put your own key where it says YOUR_KEY. Put your own value where it says PASTE_…_HERE: the table above says where each one comes from. New here? Start with your first call.
What you get back
When it worked, the answer is { "ok": true, "result": { … } }. Inside result:
sent | |
conversationId | A chat id. Other actions take it. |
messageId | A message id. Other actions take it. |
text | |
from | the account it ran on |
usedToday | number |
dailyLimit | number |
A field that does not apply to an answer is left out, or is null.
When it did not work, the answer is { "ok": false, "error": "…", "message": "…" }. What each error means.
Good to know
- Pass profileUrl or conversationId, one of them.
- LinkedIn delivers an ordinary message only to a 1st-degree connection. For anyone else: send_invitation first, or start_conversation with inmail.
What its answer goes into
get_chatGet a chatlist_chat_messagesList a chat's messageslist_chat_participantsList who is in a chatsend_chat_messageSend a message with files or a voice noteset_chat_statusMark a chat read or muted on LinkedInresync_chatRe-read a chat's historydelete_chatDelete a chatget_messageGet a messageget_message_attachmentDownload a message attachmentedit_messageEdit a sent messagedelete_messageDelete a sent messagereact_to_messageReact to a messageget_inmail_conversationGet an InMail conversation
Guides that use it
- How to use GPT-6.2 Astra for your LinkedIn
- How to read back every LinkedIn conversation with one person
- How to edit or unsend a LinkedIn message from your AI app
- How to search your own LinkedIn connections from your AI app
- How to use Grok Bot for your LinkedIn
- An AI SDR for LinkedIn that asks before it sends
- How to use Jev in n8n to sort your LinkedIn inbox
- LinkedIn message automation, one person at a time
- How to use ChatGPT dots for your LinkedIn
- How to follow up on LinkedIn conversations that went quiet
- Expandi's guide to LinkedIn lead generation with Claude
In Claude or ChatGPT
Once connected, ask in your own words. The assistant sees this action as a tool with the same name, send_message, and the same inputs.
More in Messages
list_conversationsList conversationsget_conversationGet a conversationmark_readMark a conversation read in this inboxsync_inboxRefresh the inboxget_send_statusCheck how an inbox refresh endedlist_chatsList chatsget_chatGet a chatlist_chat_messagesList a chat's messageslist_chat_participantsList who is in a chatsend_chat_messageSend a message with files or a voice notestart_conversationStart a conversation (InMail, group, company)set_chat_statusMark a chat read or muted on LinkedInresync_chatRe-read a chat's historydelete_chatDelete a chatlist_messagesList messages across chatsget_messageGet a messageget_message_attachmentDownload a message attachmentedit_messageEdit a sent messagedelete_messageDelete a sent messagereact_to_messageReact to a messagelist_chat_attendeesList everyone I have chats withget_chat_attendeeGet a chat participantget_chat_attendee_pictureDownload a participant's picturelist_attendee_chatsList my chats with one personlist_attendee_messagesList my messages with one personresync_attendee_chatsRe-read my chats with one person