SalesTouch Docs
All MCP tools
Writes to LinkedInLinkedIn

Add lead to Sales Navigator list

linkedin_sales_navigator_add_lead_to_list

Add one LinkedIn member to an existing Sales Navigator lead list.

When to use it

Add one exact LinkedIn member to an existing Sales Navigator lead list.

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

Requirements

Provide list_id from linkedin_sales_navigator_get_lead_lists.
Provide the exact user_id returned by a LinkedIn profile lookup, search, or list result; never guess it.
The selected account must have Sales Navigator access.

Example

Ask your agent

Add LinkedIn user user_456 to Sales Navigator lead list list_456.

Tool arguments
{
  "list_id": "list_456",
  "user_id": "user_456"
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: A deterministic saved confirmation containing the lead-list and user ids.

Parameters

account_id
string

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

list_idrequired
string

Exact Sales Navigator lead-list id returned by linkedin_sales_navigator_get_lead_lists.

user_idrequired
string

Exact LinkedIn user id to save.

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.

sales_navigator_required

Select or connect a LinkedIn account with active Sales Navigator access.

search_parameter_not_resolved

Inspect the returned candidates and retry the filter with the intended candidate id.

deprecated_filter_v2

Run the equivalent native Sales Navigator search by URL because this legacy filter is absent from the v2 structured contract.

filter_not_expressible_v2

Use a native Sales Navigator search URL to preserve this exact filter intent.