SalesTouch Docs
All MCP tools
Writes to LinkedInLinkedIn

Update lead tags

lead_tags_update

Add or remove simple workspace tags on a lead.

When to use it

Add or remove simple workspace-specific tags on one lead.

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

Requirements

Provide lead_id or a LinkedIn member target.
Provide at least one tag in add or remove.

Example

Ask your agent

Add the Founder tag and remove Agency from this lead.

Tool arguments
{
  "lead_id": "lead_example",
  "add": [
    "Founder"
  ],
  "remove": [
    "Agency"
  ]
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: The complete updated lead status with the resulting sorted tag names.

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 returned by lead_status or leads_search.

add
array

Additional tool input.

remove
array

Additional tool input.

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