SalesTouch Docs
All MCP tools
Read onlyLinkedIn

LinkedIn conversation messages

linkedin_conversations_messages

Read one provider page of messages from a LinkedIn conversation resolved from a chat id or profile target. order controls item presentation within that page only; opaque cursors traverse older pages regardless of order. One page is not the complete history.

When to use it

Load one provider page of message history for a known conversation or member.

Required scopes
linkedin:accesssalestouch:use
Execution
Synchronous MCP tool call

Requirements

Provide a linkedin_conversation_id/chat_id/thread_id or a member target.
account_id is optional when SalesTouch can resolve a connected account automatically.
Reuse the returned cursor unchanged with the same conversation and filters while has_more is true. Each continuation loads an older provider page regardless of order; oldest_first is chronological within each page, not across pages.

Example

Ask your agent

Read up to 50 messages with https://www.linkedin.com/in/example, oldest first within the page. While has_more is true, use the returned cursor to read older pages with the same settings.

Tool arguments
{
  "identifier": "https://www.linkedin.com/in/example",
  "limit": 50,
  "order": "oldest_first"
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: One page of normalized messages plus conversation participants, cursor, and has_more. A single page must not be treated as the complete conversation history. When no thread exists yet with the member, items is empty, conversation is null and conversation_found is false.

Parameters

account_id
string

Connected SalesTouch account id, username, email, handle, or account URL.

identifier
string

LinkedIn member handle, public id, account id, or profile URL.

lead_id
string

Canonical SalesTouch lead id. Resolved locally before any LinkedIn provider request.

cursor
string

Opaque provider cursor returned by the previous page. Following it retrieves older pages regardless of order.

before
string

ISO 8601 UTC datetime upper bound.

after
string

ISO 8601 UTC datetime lower bound.

linkedin_conversation_id
string

LinkedIn conversation id or provider chat id. Do not confuse it with conversation_id, which carries the PostHog MCP analytics session.

limit
integer

Maximum messages to return per page. Defaults to 50.

sender_id
string

Filter messages by provider sender id.

include_participants
boolean

Include normalized conversation attendees. Defaults to true.

order
string

Message order within each provider page only. Defaults to oldest_first. Does not change cursor traversal towards older pages.

Aliases are shown independently because MCP clients send a flat JSON object. Use one alias from each required group, not every alias.

Common errors

insufficient_scope

Reconnect the MCP and approve the requested LinkedIn permission.

paid_plan_required

Follow the error's action_url: start the free trial, choose a plan after a trial or subscription ended, or update the payment method after a failed payment. details.reason names which one.

trial_payment_method_required

Retry after a minute if checkout was just completed; otherwise add a payment method in SalesTouch billing to activate the trial and LinkedIn MCP access.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools