# send_invitation: Send an invitation

Send one connection invitation, 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_invitation
Authorization: Bearer YOUR_KEY
content-type: application/json

{
  "profileUrl": "PASTE_PROFILE_LINK_HERE"
}
```

## What you give it

- `profileUrl` (needed): a profile link. The person's LinkedIn profile URL (linkedin.com/in/…). 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`.
- `note` (optional): text, up to 300 characters. Optional note sent with the invitation (max 300 characters).
- `email` (optional): an email address. The person's email address — only for someone whose LinkedIn settings ask for it before they can be invited.
- `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`
- `profileUrl`
- `invitationId`: a sent invitation id
- `withNote`
- `from`: the account it ran on
- `usedToday`: number
- `dailyLimit`: number

## Good to know

- A link or an id that is not an ordinary member id (ACo…) is first looked up, which LinkedIn counts as a profile view.
- LinkedIn's own weekly invitation limit can refuse it: the error is linkedin_limit_reached.
- When the person already has an unanswered invitation from you, LinkedIn answers as if it sent one and hands back that older invitation's id.

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