Docs

HeyReagent lets your own tools do things on your LinkedIn account: send a message, search for people, read a post. Each thing it can do is called an action. You ask for one action at a time.

Start in three steps

1. Sign in and connect LinkedIn. Sign in with your email: we send you a link, and there is no password. The page you land on, your thread page, shows a LinkedIn card. Press Connect on it and sign in to LinkedIn there. You do that once.
2. Get your key. On the thread page open Menu, then Developers, and press Create a key. Copy it straight away: it is shown only once. The key is your password here, so keep it to yourself.
3. Call an action. The next part shows how.

Your first call

Try this one first. It only reads: it lists the LinkedIn accounts you connected.

curl -X POST https://api.heyreagent.com/v1/actions/list_linkedin_accounts \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{}'

const response = await fetch("https://api.heyreagent.com/v1/actions/list_linkedin_accounts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_KEY",
    "content-type": "application/json",
  },
  body: JSON.stringify({}),
});
const answer = await response.json();
console.log(answer);

import requests

response = requests.post(
    "https://api.heyreagent.com/v1/actions/list_linkedin_accounts",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={},
)
print(response.json())

{}

Every call is made the same way. Only three things change:

The answer says whether it worked:

Anything that can send a request like this can call an action: a script, your own app, or a workflow tool such as n8n. Each action's page shows the call in curl, JavaScript, Python and n8n, with what to put in and what comes back.

GET https://api.heyreagent.com/v1/actions, with the same header, lists every action your plan includes and its inputs.

Use it from Claude or ChatGPT

Claude, ChatGPT, Claude Code, Cursor and n8n can run the same actions for you when you ask in plain words. They connect over MCP, at this address. Open your app below for its steps.

Create a custom connector called HeyReagent for my LinkedIn. It is a remote MCP server over streamable HTTP at https://api.heyreagent.com/mcp. Every request needs the header "Authorization: Bearer" followed by my key. Ask me for the key in your secure form, not in this chat. Then list its tools and run get_my_profile to check that it works.

claude mcp add --transport http heyreagent https://api.heyreagent.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

{
  "mcpServers": {
    "heyreagent": {
      "url": "https://api.heyreagent.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Any other MCP client: give it the address, and your key as a bearer token, the header Authorization: Bearer YOUR_KEY.

Hand the docs to an AI app

Paste one of these into ChatGPT or Claude and ask it to write the call or the workflow for you. Every docs page also has a button at its top that copies that page.

When it says no

A call that did not work answers with "ok": false, an error word and a message in plain English. These are the ones you will meet:

An action can also refuse for a reason of its own, with an error word of its own. The message says what to change.

Two things that go wrong without an error word:

• The answer is a web page that says Cannot GET. The request was sent as a GET. It has to be a POST.
• An input seems to do nothing. An input name the action does not know is left out without a word. Check its spelling against the action's page.

Do more than one thing

One action does one thing. To get something done you run a few in a row, and the answer of one gives you what the next one needs. Recipes shows the common ones step by step:

• Find people and invite them
• Take back an invitation nobody answered
• Read a conversation and reply
• Answer the invitations you received
• Invite the people who reacted to a post
• Search with a LinkedIn filter (for example, a city)
• Comment on someone's latest post

What actions hand to each other are ids and links. Ids and links says what each one is, which action gives it, and which action takes it.

Limits

Each LinkedIn account has a daily limit per kind of action, to keep the account safe. Reading your conversations is not limited. get_usage shows what is used and what is left. An action past a limit is refused with the time it resets.

Invitations have more limits

Invitations are also limited over a week and, on a free LinkedIn account, in how many can carry a note. How many you can send depends on whether the LinkedIn account is a paid one (Premium, Sales Navigator or Recruiter) or a free one. An account HeyReagent cannot tell apart counts as free.

Past the 7 days' limit an invitation is refused with weekly_limit_reached. Past the notes of a free account it is refused with note_limit_reached: send it without a note. A note that is too long is refused with note_too_long.

What the limits do not do for you

• Spread your calls over the day. Calls made at the same minute every day can be flagged as automation.
• A LinkedIn account that is new, has few connections, or was not used for a long time should start well below these numbers and go up gradually.
• LinkedIn can refuse sooner than these numbers. The answer is then linkedin_limit_reached.

Sales Navigator, Recruiter and job-posting actions run on your own LinkedIn account and need that product on it. An action that downloads a file returns it as file: { contentType, base64 } on the API, and as a file over MCP.

Plans

Every account starts on the free plan, which has every action marked Connect below. What it does not have is a connection that lasts: LinkedIn is disconnected after an hour without use, and 12 hours after connecting at the latest. An action then answers linkedin_disconnected, and connect_linkedin gives the link to connect it again. Only so many free accounts can be connected at once. The Connect plan keeps LinkedIn connected, so scheduled workflows run. The actions marked Agent need the Agent plan.

Actions

Click an action to see what to give it, how to call it, and what comes back.