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 and ChatGPT can run the same actions for you when you ask in plain words. They connect over MCP, at this address:

https://api.heyreagent.com/mcp

Claude. Open Customize, then Connectors. Click + Add, then Add custom connector. Type a name, paste the address above, and click Continue. Keep the sign-in settings Claude found, continue, and click Add. Sign in to HeyReagent when Claude asks. In a chat, press + at the lower left, then Connectors, to switch it on. Claude's own guide has pictures of each screen.

ChatGPT. Open Settings, then Security and login, and turn on Developer mode. Go to ChatGPT Plugins, select the plus button, type a name and a description, enter the address above, and create the connection. Sign in to HeyReagent when ChatGPT asks. In a chat, choose Developer mode from the plus menu and select it. ChatGPT's own guide says which accounts have developer mode.

n8n, Cursor and other MCP clients. Give them the address above, and your key as a bearer token: the header Authorization: Bearer YOUR_KEY. In n8n's MCP Client Tool node that is Endpoint: the address, Server Transport: HTTP Streamable, Authentication: Bearer Auth.

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 today's counts. An action past its limit is refused with the time it resets.

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.