# send_message: Send a message

Send one message to a 1st-degree connection, or into an existing conversation, now. This action can change or spend something, and it happens right away. Plan: Free and Connect.

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

{
  "profileUrl": "PASTE_PROFILE_LINK_HERE",
  "text": "Hello!"
}
```

## What you give it

- `text` (needed): text, up to 8000 characters. The message text.
- `profileUrl` (optional): a profile link. LinkedIn profile URL of the 1st-degree connection to message. Where to get it: 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`.
- `conversationId` (optional): a chat id. Id of an existing conversation to send into, instead of a profile URL. Where to get it: Run `list_chats` and use `chats[].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`
- `conversationId`: a chat id
- `messageId`: a message id
- `text`
- `from`: the account it ran on
- `usedToday`: number
- `dailyLimit`: number

## 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.

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