ReferenceCommands
Enrich Lead
Trigger LinkedIn enrichment and signal capture on an existing lead.
leadsmutateallow
Enrich Lead
Trigger LinkedIn enrichment and signal capture on an existing lead.
When to use
Use this before writing a personalized message or to refresh stale context before a follow-up.
Risk notes
- This command mutates product data by fetching and storing fresh prospect context.
Output notes
- Pass `targets` to limit enrichment to specific domains: `profile`, `posts`, and `company`.
- When `targets` is provided, unselected steps return `skipped_not_requested`.
- Responses default to `full` mode through the public API and CLI.
- Use `compact` only when token savings matter more than prospecting quality. It can noticeably reduce prospecting quality.
Output schema
json
{
"type": "object",
"properties": {
"lead_id": {
"type": "string"
},
"linkedin_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requested_targets": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"enum": [
"profile",
"posts",
"company"
]
}
},
{
"type": "null"
}
]
},
"decision": {
"type": "string",
"enum": [
"skip",
"profile_company_and_posts",
"profile_and_posts",
"profile_and_company",
"profile_only",
"company_and_posts",
"company_only",
"posts_only"
]
},
"profile": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"failed",
"refreshed",
"skipped_fresh",
"skipped_not_needed",
"skipped_not_requested"
]
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data": {
"anyOf": [
{
"description": "Arbitrary JSON value.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
{
"type": "null"
}
]
}
},
"required": [
"status"
],
"additionalProperties": false
},
"company": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"failed",
"refreshed",
"skipped_fresh",
"skipped_not_needed",
"skipped_not_requested"
]
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data": {
"anyOf": [
{
"description": "Arbitrary JSON value.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
{
"type": "null"
}
]
}
},
"required": [
"status"
],
"additionalProperties": false
},
"posts": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"failed",
"refreshed",
"skipped_fresh",
"skipped_not_needed",
"skipped_not_requested"
]
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data": {
"anyOf": [
{
"description": "Arbitrary JSON value.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
{
"type": "null"
}
]
}
},
"required": [
"status"
],
"additionalProperties": false
}
},
"required": [
"lead_id",
"linkedin_url",
"requested_targets",
"decision",
"profile",
"company",
"posts"
],
"additionalProperties": false
}
CLI
bash
salestouch commands run lead.enrich --input-json '{"lead_id":"<string>","prospect_id":"<string>","email":"<string>"}' --json
Payload
json
{
"lead_id": "<string>",
"prospect_id": "<string>",
"email": "<string>"
}
Runtime Command
lead.enrich is exposed through the shared SalesTouch runtime and stays available across API, CLI and MCP.
HTTP Reference
AuthorizationBearer <token>
Use Authorization: Bearer <salestouch_api_key>.
In: header
Path Parameters
commandId*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://www.salestouch.io/api/v1/commands/string" \ -H "Content-Type: application/json" \ -d '{}'{
"ok": true,
"status": 0,
"data": {},
"error": {
"code": "string",
"message": "string"
},
"meta": {
"approval_required": true,
"approval_request_id": "string",
"command_hash": "string",
"warnings": [
"string"
]
}
}{
"ok": true,
"status": 0,
"data": {},
"error": {
"code": "string",
"message": "string"
},
"meta": {
"approval_required": true,
"approval_request_id": "string",
"command_hash": "string",
"warnings": [
"string"
]
}
}{
"error": {
"message": "string",
"code": "string"
}
}{
"error": {
"message": "string",
"code": "string"
}
}{
"ok": true,
"status": 0,
"data": {},
"error": {
"code": "string",
"message": "string"
},
"meta": {
"approval_required": true,
"approval_request_id": "string",
"command_hash": "string",
"warnings": [
"string"
]
}
}{
"ok": true,
"status": 0,
"data": {},
"error": {
"code": "string",
"message": "string"
},
"meta": {
"approval_required": true,
"approval_request_id": "string",
"command_hash": "string",
"warnings": [
"string"
]
}
}{
"ok": true,
"status": 0,
"data": {},
"error": {
"code": "string",
"message": "string"
},
"meta": {
"approval_required": true,
"approval_request_id": "string",
"command_hash": "string",
"warnings": [
"string"
]
}
}Schema Reference
AuthorizationBearer <token>
Use Authorization: Bearer <salestouch_api_key>.
In: header
Path Parameters
commandId*string
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://www.salestouch.io/api/v1/commands/string/schema"{
"data": {
"command": {
"command_id": "string",
"title": "string",
"description": "string",
"summary": "string",
"visibility": "public",
"risk": "read",
"category": "linkedin",
"default_permission": "allow",
"when_to_use": "string",
"risk_notes": [
"string"
],
"output_notes": [
"string"
],
"related_commands": [
"string"
],
"related_resources": [
"string"
],
"examples": [
{
"title": "string",
"language": "string",
"code": "string"
}
],
"input_schema": {},
"output_schema": {},
"approval_output_schema": {}
}
}
}{
"error": {
"message": "string",
"code": "string"
}
}{
"error": {
"message": "string",
"code": "string"
}
}{
"error": {
"message": "string",
"code": "string"
}
}