Docs / Insight
who_is_waiting_on_me
List the people whose last message you have not answered.
This action only reads. It changes nothing, so it is safe to try.
What you give it
| Input | What it is | Where to get it |
|---|---|---|
connectionIdoptional | A connection id. Restrict to one LinkedIn sender. Omit to span all live senders in this setup. | Run list_linkedin_accounts and use accounts[].id from its answer.15 more places to get it
|
limitoptional | A number, 1 to 200. Max people to return (1–200, default 100). | You write it. |
Call it
curl -X POST https://api.heyreagent.com/v1/actions/who_is_waiting_on_me \
-H "Authorization: Bearer YOUR_KEY" \
-H "content-type: application/json" \
-d '{}'The same call in JavaScript
const response = await fetch("https://api.heyreagent.com/v1/actions/who_is_waiting_on_me", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_KEY",
"content-type": "application/json",
},
body: JSON.stringify({}),
});
const answer = await response.json();
console.log(answer);The same call in Python
import requests
response = requests.post(
"https://api.heyreagent.com/v1/actions/who_is_waiting_on_me",
headers={"Authorization": "Bearer YOUR_KEY"},
json={},
)
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/who_is_waiting_on_me |
| 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 |
{}Put your own key where it says YOUR_KEY. New here? Start with your first call.
What you get back
When it worked, the answer is { "ok": true, "result": { … } }. Inside result:
summary | |
waitingOnYou | |
nextAction | |
note |
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
- It reads the stored inbox. needsInboxSync names the accounts whose copy is missing or over 7 days old: run sync_inbox first.
- To answer someone, pass the row's profileUrl to send_message. profileUrl can be null on a row.
What its answer goes into
get_profileGet a profileget_profile_detailsGet a profile in depthsend_invitationSend an invitationget_conversationGet a conversationsend_messageSend a messagesync_inboxRefresh the inboxstart_conversationStart a conversation (InMail, group, company)list_inmailList InMail conversationsget_recent_postsGet someone's recent postslist_posts_by_authorList a person's or company's postslist_comments_by_personList the comments a person wrotelist_reactions_by_personList what a person reacted to
Guides that use it
- How to use GPT-6.2 Astra for your LinkedIn
- How to use Gemini 4 Hydrogen for your LinkedIn inbox
- How to mute or delete LinkedIn conversations from your AI app
- Nod from n8n Labs: can it do your LinkedIn work?
- Muse spaces: a LinkedIn follow-up board in your Muse app
- Muse voice: talking to your Muse about your LinkedIn
- How to use Grok Bot for your LinkedIn
- Muse in Singapore: can it work your LinkedIn?
- An AI SDR for LinkedIn that asks before it sends
- What Claude Duet means for your LinkedIn work
- How to use Jev in n8n to sort your LinkedIn inbox
- How to use Claude Haiku 5.5 on your LinkedIn inbox
- LinkedIn message automation, one person at a time
- How to use ChatGPT dots for your LinkedIn
- Gemini 4 Carbon in n8n: how to use it for your LinkedIn work
- An AI agent that answers your LinkedIn messages
- Expandi's guide to LinkedIn lead generation with Claude
In Claude or ChatGPT
Once connected, ask in your own words. The assistant sees this action as a tool with the same name, who_is_waiting_on_me, and the same inputs.
More in Insight
who_went_coldWho went coldconnections_never_messagedConnections I never messagedengagers_not_connectedEngagers I am not connected to