Messages

List messages across chats

List messages across all your conversations, newest first.

Docs: https://heyreagent.com/docs/actions/list_messages

post/v1/actions/list_messages

Request

  • Base URL: https://api.heyreagent.com
  • URL: https://api.heyreagent.com/v1/actions/list_messages
  • Auth: HTTP bearer

Request body

senderIdstring

Only messages from this participant id. The published definition calls this "the id of the sender" without saying which id; "participant id" is this tool's own wording.

beforestring date-time

Only items created before this moment (ISO 8601 UTC, e.g. 2026-10-01T00:00:00.000Z).

afterstring date-time

Only items created after this moment (ISO 8601 UTC, e.g. 2026-10-01T00:00:00.000Z).

limitnumber

How many to return (1–250, default 50).

cursorstring

nextCursor from the previous call, to get the next page. Keep the other arguments the same.

connectionIdstring

Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

Response

It worked. Inside result: returned, nextCursor, messages[].messageId, messages[].providerId, messages[].senderId, messages[].text, messages[].attachments[].id, messages[].id, messages[].chatId, messages[].chatProviderId, messages[].timestamp, messages[].isSender, messages[].isForwarded, messages[].isViewOnce, messages[].seen, messages[].hidden, messages[].deleted, messages[].edited, messages[].isEvent, messages[].delivered, messages[].behavior, messages[].eventType, messages[].original, messages[].replies, messages[].replyBy, messages[].parent, messages[].senderAttendeeId, messages[].subject, messages[].messageType, messages[].attendeeType, messages[].attendeeDistance, messages[].senderUrn.

oktrue required
resultobject required

What was asked for. A field that does not apply is left out, or is null.

Changes

No recorded changes to this operation across all 1 revision of this API.