SalesTouch Docs
All MCP tools
Read onlyLinkedIn

LinkedIn conversations

linkedin_conversations_list

List recent LinkedIn messaging conversations from connected accounts.

When to use it

Read the unified global LinkedIn conversation feed or iterate explicit Classic, Sales Navigator, company, folder, or inbox-id streams.

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

Requirements

account_id is optional when SalesTouch can resolve a connected account automatically.
Omit inbox_tags for the deduplicated global feed; use one or more tags returned by linkedin_inboxes_list to narrow it.
Reuse a cursor only with the same accounts, date/unread filters, inbox selection, and sort_by value.

Example

Ask your agent

List my 20 most recent unread LinkedIn conversations and include participants.

Tool arguments
{
  "limit": 20,
  "unread": true,
  "include_participants": true
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: A stable paginated list with inbox product/folder metadata and an opaque query-bound multi-inbox cursor.

Parameters

account_id
string

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

cursor
string

Pagination cursor.

before
string

ISO 8601 UTC datetime upper bound.

after
string

ISO 8601 UTC datetime lower bound.

inbox_tags
array

Readable tags returned by linkedin_inboxes_list. Values are ORed. Examples: classic_primary, sales_navigator, archived, company_primary, company_123_primary, unread. Derived views are queried only when their folder tag is explicit.

sort_by
string

Use last_message_at for the unified global feed (default), or inbox to iterate streams in deterministic account/product/folder order.

limit
integer

Maximum conversations to return. Defaults to 25.

unread
boolean

Filter unread or read conversations.

include_participants
boolean

Include normalized conversation attendees.

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