Writes to LinkedInLinkedIn

Call a data tool

data_call

Call one data tool returned by data_search and pay for it with the workspace's agent credits. Pass query parameters in query and the JSON body in body, as data_describe shows. max_credits caps this one call (default 2000 credits); a call estimated above it is refused before anything is charged. Returns the provider answer and credits_charged. A provider error is returned with its status: fix the input rather than retrying blindly. Never repeat a call that returned data_result_unknown.

When to use it

Enrich a lead or fetch external data and pay for it with your workspace's agent credits.

Required scopes

linkedin:accesssalestouch:use

Execution

Synchronous MCP tool call

Requirements

Provide id from data_search and the inputs shown by data_describe.

The workspace needs available agent credits. Analysts cannot spend credits.

Example

Ask your agent

Find the work email of https://www.linkedin.com/in/example-person with a data tool.

Tool arguments

{
  "id": "salestouch.people.email.find",
  "body": {
    "linkedin_url": "https://www.linkedin.com/in/example-person"
  },
  "max_credits": 300
}

MCP response envelope

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: The provider answer, its HTTP status and the credits charged for this call.

Parameters

NameTypeDescription

idrequired

string

Data tool id returned by data_search.

query

object

Query string parameters, as listed by data_describe.

body

object

JSON request body, as listed by data_describe.

max_credits

number

Most credits this call may cost. Defaults to 2000.

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.

credits_required

Add agent credits to the workspace in SalesTouch, then retry.

data_cost_limit

Raise max_credits or narrow the request.

data_result_unknown

Do not repeat the call: any charge is settled automatically.