List messages

Fetch messages for a specific conversation, with cursor-based pagination and ordering control.

Pagination: pass pagination.nextCursor from a prior response back as the cursor query param to fetch the next page. The cursor is opaque; do not parse or construct it client-side.

Sort order: defaults to asc (oldest first, chat style). For the "show me the latest messages" pattern, pass ?sortOrder=desc&limit=N. For Twitter, Facebook and Bluesky, the upstream APIs only return newest-first and have no order parameter — sort order is best-effort and only reverses items within a single page (pages still walk newest→oldest). The response field sortOrderApplied tells you what was actually applied.

Reddit threads are paginated client-side because Reddit's API has no per-thread cursor. Very long threads may be upstream-truncated by Reddit's inbox/sent windows (~100 most-recent items each); this is a Reddit platform limitation.

Twitter/X limitation: X's encrypted "X Chat" messages are not accessible via the API. Conversations where the other participant uses encrypted X Chat may only show your outgoing messages. See the list conversations endpoint for more details.

GET /v1/inbox/conversations/{conversationId}/messages

Fetch messages for a specific conversation, with cursor-based pagination and ordering control.

Pagination: pass pagination.nextCursor from a prior response back as the cursor query param to fetch the next page. The cursor is opaque; do not parse or construct it client-side.

Sort order: defaults to asc (oldest first, chat style). For the "show me the latest messages" pattern, pass ?sortOrder=desc&limit=N. For Twitter, Facebook and Bluesky, the upstream APIs only return newest-first and have no order parameter — sort order is best-effort and only reverses items within a single page (pages still walk newest→oldest). The response field sortOrderApplied tells you what was actually applied.

Reddit threads are paginated client-side because Reddit's API has no per-thread cursor. Very long threads may be upstream-truncated by Reddit's inbox/sent windows (~100 most-recent items each); this is a Reddit platform limitation.

Twitter/X limitation: X's encrypted "X Chat" messages are not accessible via the API. Conversations where the other participant uses encrypted X Chat may only show your outgoing messages. See the list conversations endpoint for more details.

Parameters

• conversationId (path, string) required — The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.

• accountId (query, string) required — Social account ID

• limit (query, integer) — Number of messages to return per page. Default 100, max 100.

• cursor (query, string) — Opaque pagination cursor. Pass pagination.nextCursor from a prior response.

• sortOrder (query, string) — Order of returned messages. Default asc (oldest first, chat style). For Twitter, Facebook and Bluesky, only intra-page ordering is affected — pages always walk newest→oldest. See sortOrderApplied in the response.

Responses

200 — Messages in conversation

• status (string)
• pagination (object)
• sortOrderApplied (string) (enum: asc, desc) — Sort order actually applied to the returned page. May differ from the requested sortOrder for Twitter, Facebook and Bluesky (always desc regardless of request).
• messages (array)
• lastUpdated (string)

401

403 — Inbox addon required