Docs / Network
send_invitation
Send one connection invitation, 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 |
|---|---|---|
profileUrlneeded | A profile link. The person's LinkedIn profile URL (linkedin.com/in/…). | 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
|
noteoptional | Text, up to 300 characters. Optional note sent with the invitation (max 300 characters; 200 on a free LinkedIn account). | You write it. |
emailoptional | An email address. The person's email address — only for someone whose LinkedIn settings ask for it before they can be invited. | You write 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_invitation \
-H "Authorization: Bearer YOUR_KEY" \
-H "content-type: application/json" \
-d '{"profileUrl":"PASTE_PROFILE_LINK_HERE"}'The same call in JavaScript
const response = await fetch("https://api.heyreagent.com/v1/actions/send_invitation", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_KEY",
"content-type": "application/json",
},
body: JSON.stringify({
"profileUrl": "PASTE_PROFILE_LINK_HERE"
}),
});
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_invitation",
headers={"Authorization": "Bearer YOUR_KEY"},
json={
"profileUrl": "PASTE_PROFILE_LINK_HERE",
},
)
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_invitation |
| 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"
}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 | |
profileUrl | |
invitationId | A sent invitation id. Other actions take it. |
withNote | |
from | the account it ran on |
usedToday | number |
dailyLimit | number |
usedLast7Days | |
weeklyLimit |
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
- A link or an id that is not an ordinary member id (ACo…) is first looked up, which LinkedIn counts as a profile view.
- A free LinkedIn account can send fewer than a paid one (Premium, Sales Navigator or Recruiter), and only a few with a note: the numbers are under Limits, and get_usage shows what is left.
- Past the invitations with a note a free account has, the error is note_limit_reached: send it without a note.
- LinkedIn's own invitation limit can refuse it sooner: 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.
What its answer goes into
withdraw_invitationWithdraw one sent invitation, now
Guides that use it
- How to find companies that just raised money, and who to talk to there
- Nod from n8n Labs: can it do your LinkedIn work?
- How to invite the people who reacted to a LinkedIn post
- How to use Grok Bot for your LinkedIn
- Muse in Singapore: can it work your LinkedIn?
- n8n 3.0: what to check in your LinkedIn workflows
- An AI SDR for LinkedIn that asks before it sends
- HeyReach, Apify and Claude: check who is active before you invite
- What Claude Duet means for your LinkedIn work
- Claude Opus 5.5: what it changes for your LinkedIn
- Expandi's guide to LinkedIn lead generation with Claude
- How to send LinkedIn invitations from 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_invitation, and the same inputs.
More in Network
list_connectionsList my connectionslist_sent_invitationsList sent invitationspreview_withdraw_invitationsPreview withdrawing invitationswithdraw_invitationsWithdraw sent invitationswithdraw_invitationWithdraw one sent invitation, nowlist_received_invitationsList received invitationsrespond_to_invitationAccept or decline an invitationlist_followersList followers