POST/campaigns/:campaignId/leads
Manual lead insert by email. 1 credit when status is created; 0 for duplicate / excluded. Optional Idempotency-Key. Rate class: add_lead.
Request
POST /campaigns/search-xyz/leads
X-API-Key: sk_live_...
Content-Type: application/json
Idempotency-Key: demo-1
{
"email": "jane@acme.com",
"fullName": "Jane Doe",
"companyName": "Acme Dental",
"website": "https://acme.com"
}
| Field | Required | Max |
|---|---|---|
email | Yes | 254 |
fullName | No | 120 |
companyName | No | 200 |
website | No | 500 |
Response
{
"leadId": "lead_abc",
"status": "created",
"creditsCharged": 1
}
status ∈ created | duplicate | excluded.
Errors
| Error code | When |
|---|---|
insufficient_credits | Balance < 1 |
validation_error | Bad body |
not_found | Unknown campaign |
conflict | Idempotency mismatch / in progress |
MCP
Tool: add_lead.