---
title: "LinkedIn proxy: list messenger conversations (paged)"
method: GET
path: "/api/linkedin/{account_id}/conversations"
tags: ["LinkedIn – Inbox"]
---

# LinkedIn proxy: list messenger conversations (paged)

`GET /api/linkedin/{account_id}/conversations`

## Request

- Base URL: `https://api.reachmcp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reachmcp.com/api/linkedin/{account_id}/conversations`
- Auth: API key in header `X-API-Key`

Uses the same Voyager Messaging GraphQL calls as Kanbox (``sync_conversations``, ``sync_archived_conversations``, unread search) and returns rows shaped like ``sync_linkedin_conversations_new_format``.

## Path parameters

- `account_id` integer, required

## Query parameters

- `archived` boolean: Archived folder (``category:ARCHIVE`` when not using unread search).
- `unread` boolean: Only unread threads (search query with ``read:false``).
- `starred` boolean: Starred only: ``category:STARRED`` for primary inbox; combined with archived/unread, results are filtered to ``STARRED`` in ``categories``.
- `count` integer: Page size (Kanbox uses 25).
- `next_cursor` string, nullable: Cursor from the previous response for the same filters.

## Response `200`

Successful Response

- LinkedInMessengerConversationsPageOut: Paged messenger list (Voyager Messaging GraphQL).
  - `archived` boolean, required: Matches query: archived folder (``category:ARCHIVE``) when not unread.
  - `unread` boolean, required: Matches query: unread filter (search query with ``read:false``).
  - `starred` boolean, required: Matches query: starred folder or client filter when combined.
  - `count` integer, required: Requested page size (LinkedIn typically caps at 25).
  - `next_cursor` string, nullable: Pass as ``next_cursor`` for the following page when present.
  - `items` LinkedInConversationListItemOut[], required
    - `conversation_id` string, required: LinkedIn messaging thread id (``backendUrn`` → ``messagingThread:<id>``). Use this as ``conversation_linkedin_id`` when fetching messages or replying.
    - `thread_id` string, required: Same as ``conversation_id`` — kept for backward compatibility.
    - `recipient_linkedin_id` string, nullable: ``fsd_profile`` id of the other participant (1:1 chats only; ``None`` for group chats). Use this as ``recipient_linkedin_id`` when sending a new message.
    - `is_groupchat` boolean
    - `unread_count` integer
    - `is_read` boolean
    - `is_archived` boolean
    - `is_starred` boolean
    - `is_muted` boolean
    - `last_activity_at` string, date-time, nullable
    - `last_read_at` string, date-time, nullable
    - `last_message_text` string, nullable
    - `participant_firstname` string
    - `participant_lastname` string
    - `participant_headline` string, nullable
    - `participant_picture` string, nullable
    - `participant_linkedin_id` string, nullable: Same as ``recipient_linkedin_id`` — kept for backward compatibility.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/reachmcp/apis/mcp-reach.md) · [All operations](https://skmtc.dev/reachmcp/apis/mcp-reach/llms.txt) · [OpenAPI document](https://skmtc.dev/reachmcp/apis/mcp-reach/revisions/1a85fdaf3f7c?raw)