Create lead
create_leadAdd a lead to the shop pipeline with contact, service, source, and optional value; reuse an idempotency key on retries to avoid duplicates and receive a rule-based priority score.
Instructions
Add a lead to the shop pipeline. Money is integer cents (480000 = $4,800.00), never dollars. Pass an idempotencyKey when retrying so a duplicate submit returns the original lead. A reused key with a different payload is a conflict. The response includes the rule-based priority score.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"contactName": "<contactName>",
"service": "<service>",
"source": "<source>"
},
"name": "create_lead"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| No | Optional. Use null when the caller did not give one. | ||
| notes | No | ||
| phone | No | Optional. Digits, spaces, and + ( ) . - only. | |
| stage | No | Defaults to new. | |
| source | Yes | How the lead arrived. | |
| service | Yes | The job in the customer’s words. | |
| urgency | No | Defaults to normal. | |
| contactName | Yes | Person to call back. Not a company name. | |
| idempotencyKey | No | Send the same key on retry to avoid a duplicate lead. A different payload with the same key is a conflict. | |
| estimatedValueCents | No | Integer cents, not dollars. 480000 means $4,800.00. Use 0 when unknown. |