HeyReagent / LinkedIn API for messages

A LinkedIn API for messages, invitations and search

LinkedIn has an API for messaging, and you probably cannot use it: it is restricted to approved partners. HeyReagent is a plain API for your own LinkedIn account instead. One POST sends a message, another an invitation, another searches people. It is free to start, and it is not made by LinkedIn.

What LinkedIn's own API allows

One call

Sign in, connect your LinkedIn, and create a key under Menu, then Developers. This sends a message to a connection:

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:

MethodPOST
URLhttps://api.heyreagent.com/v1/actions/send_message
Send HeadersOn. Name Authorization, Value Bearer YOUR_KEY
Send BodyOn. Body Content Type JSON, Specify Body Using JSON, then paste the body below
{
  "profileUrl": "PASTE_PROFILE_LINK_HERE",
  "text": "Hello!"
}

Every action is called the same way: a POST to https://api.heyreagent.com/v1/actions/ and its name, your key in the Authorization header, the inputs as JSON. The answer is { "ok": true, "result": { … } }, or { "ok": false, "error": "…", "message": "…" } with the reason in plain English.

What there is

97 actions. The ones most asked for:

Every action, each with its inputs, an example call in four languages, and what comes back.

For your tools

OpenAPI 3.1https://heyreagent.com/openapi.json, for anything that imports one.
For AI appshttps://heyreagent.com/llms-full.txt: the whole of the docs as one Markdown file, to paste into ChatGPT or Claude. llms.txt is the index.
MCPThe same actions as tools for Claude, ChatGPT, Cursor and n8n. The address.

Limits

Each LinkedIn account has a daily limit for each kind of action, built in. Reading your conversations is not limited.

WhatA day
Invitations sent80
Invitations accepted or declined100
Invitations taken back100
Messages sent100
InMails sent40
Messages edited, deleted or reacted to, and conversations deleted100

All the limits, and what each refusal means.

Questions

Does LinkedIn have an API?

Yes, and most of it is not open to everyone. Its Messages API page says usage is restricted to approved partners, and its Sales Navigator API page says LinkedIn is not currently accepting new partners.

Is there a LinkedIn API to send messages?

LinkedIn’s own is for approved partners, and its documentation says a message must be tied to a specific member action, not an automated or scheduled event. HeyReagent is a separate, independent API that sends on your own account: one POST to send_message.

Is it free?

There is a free plan with every Connect action, on which LinkedIn is disconnected after a while without use. The Connect plan, at $29.99 a month for each LinkedIn account, keeps it connected.

Is there an OpenAPI file?

Yes: https://heyreagent.com/openapi.json. The docs are also there as one Markdown file for AI apps: https://heyreagent.com/llms-full.txt.

Is this LinkedIn’s official API?

No. HeyReagent is not affiliated with, endorsed by, or sponsored by LinkedIn. It acts on your own account, and LinkedIn’s User Agreement does not allow automated activity, so LinkedIn can limit or restrict an account.

Start free

Sign in with your email, connect your own LinkedIn, and paste the address. No card. When you would rather it ran LinkedIn for you, that is the Agent plan.

Start free See the plans

HeyReagent is not affiliated with, endorsed by, or sponsored by LinkedIn. LinkedIn's own terms apply to your account. What this page says about other products was read on their own pages on 5 October 2026.

More guides