SalesTouch Docs
All MCP tools
Read onlyLinkedIn

LinkedIn conversation messages

linkedin_conversations_messages

List messages from one LinkedIn conversation resolved from a chat id or profile target.

When to use it

Load the 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.

Example

Ask your agent

Read my full LinkedIn message history with https://www.linkedin.com/in/example, oldest first.

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

Expected: Normalized messages plus conversation participants and pagination state.

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

Pagination cursor.

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. Defaults to oldest_first.

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

Use a SalesTouch workspace with LinkedIn MCP access.

trial_payment_method_required

Add a payment method in SalesTouch billing to activate the trial and LinkedIn MCP access.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools