Docs / Messages
list_attendee_messages
List the messages between you and one person.
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 |
|---|---|---|
attendeeIdneeded | A attendee id. The participant id (from list_chat_attendees or list_chat_participants). | Run list_chat_attendees and use attendees[].id from its answer.6 more places to get it
|
beforeoptional | A date and time, like 2026-10-01T00:00:00.000Z. Only items created before this moment (ISO 8601 UTC, e.g. 2026-10-01T00:00:00.000Z). | You write it. |
afteroptional | A date and time, like 2026-10-01T00:00:00.000Z. Only items created after this moment (ISO 8601 UTC, e.g. 2026-10-01T00:00:00.000Z). | You write it. |
limitoptional | A number, 1 to 250. How many to return (1–250, default 50). | You write it. |
cursoroptional | A cursor. nextCursor from the previous call, to get the next page. Keep the other arguments the same. | The nextCursor from the last answer of list_attendee_messages. |
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/list_attendee_messages \
-H "Authorization: Bearer YOUR_KEY" \
-H "content-type: application/json" \
-d '{"attendeeId":"PASTE_ATTENDEE_ID_HERE"}'The same call in JavaScript
const response = await fetch("https://api.heyreagent.com/v1/actions/list_attendee_messages", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_KEY",
"content-type": "application/json",
},
body: JSON.stringify({
"attendeeId": "PASTE_ATTENDEE_ID_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/list_attendee_messages",
headers={"Authorization": "Bearer YOUR_KEY"},
json={
"attendeeId": "PASTE_ATTENDEE_ID_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/list_attendee_messages |
| 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 |
{
"attendeeId": "PASTE_ATTENDEE_ID_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:
returned | number |
nextCursor | A cursor. Other actions take it. |
messages[].messageId | string |
messages[].providerId | string |
messages[].senderId | A member id. Other actions take it. |
messages[].text | string or null |
messages[].attachments[].id | A attachment id. Other actions take it. |
messages[].id | A message id. Other actions take it. |
messages[].chatId | A chat id. Other actions take it. |
messages[].chatProviderId | string |
messages[].timestamp | string |
messages[].isSender | 0 | 1 |
messages[].isForwarded | boolean |
messages[].isViewOnce | boolean |
messages[].seen | 0 | 1 |
messages[].hidden | 0 | 1 |
messages[].deleted | 0 | 1 |
messages[].edited | 0 | 1 |
messages[].isEvent | 0 | 1 |
messages[].delivered | 0 | 1 |
messages[].behavior | 0 or null |
messages[].eventType | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 |
messages[].original | string |
messages[].replies | number |
messages[].replyBy | string[] |
messages[].parent | string |
messages[].senderAttendeeId | A attendee id. Other actions take it. |
messages[].subject | string or null |
messages[].messageType | MESSAGE | INVITATION | INMAIL | INMAIL_DECLINE | INMAIL_REPLY | INMAIL_ACCEPT | STORY_MENTION | STORY_REPLY | CONTACT |
messages[].attendeeType | MEMBER | ORGANIZATION | OTHER |
messages[].attendeeDistance | 1 | 2 | 3 | 4 | -1 |
messages[].senderUrn | string |
A field that does not apply to an answer is left out, or is null. There are 126 more fields nested inside these.
When it did not work, the answer is { "ok": false, "error": "…", "message": "…" }. What each error means.
In Claude or ChatGPT
Once connected, ask in your own words. The assistant sees this action as a tool with the same name, list_attendee_messages, and the same inputs.