Messages

List a chat's messages

List the messages of one conversation, newest first.

isSender is 1 for your own messages and 0 for the other person's.

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

post/v1/actions/list_chat_messages

Request

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

Request body

chatIdstring required

The conversation id (from list_chats).

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.