Leads

Lead management and email validation

Endpoints (10)

GET/api/leads

Auth Required

List Leads

Get all leads with optional filtering

POST/api/leads

Auth Required

Create Lead

Create a lead manually

GET/api/leads/[id]

Auth Required

Get Lead

Get lead details with job and source info

PATCH/api/leads/[id]

Auth Required

Update Lead

Update a lead's information

DELETE/api/leads/[id]

Auth Required

Delete Lead

Delete a lead

POST/api/leads/[id]/validate-email

Auth Required

Validate Lead Email

Trigger email validation for a specific lead

DELETE/api/leads/bulk

Auth Required

Bulk Delete Leads

Soft-delete multiple leads at once (max 1000), by id list or by filter

POST/api/search/web

Auth Required

Search the Web

Google results for a query, through the deployment's SerpAPI key (Serper as fallback). Provider keys stay on the server; the caller is billed CREDIT_COSTS.WEB_SEARCH credits per search, and a search that returns nothing is refunded and still answers 200 with count 0. Errors answer a bare { error } body: 400 for invalid JSON or input, 429 when rate limited, 503 when neither SERPAPI_API_KEY nor SERPER_API_KEY is set (checked before charging).

PATCH/api/leads/bulk

Auth Required

Bulk Update Leads

Update multiple leads at once

POST/api/leads/validate-bulk

Auth Required

Bulk Validate Emails

Queue email validation for multiple leads (max 1000)