Client Management
Create and manage client records to track batch spend by project or cost center, with per-client budgets and webhooks.
https://api.leadmagic.io/v1/batch/clientsTry this endpointOpen the API playground
Endpoint Details
Manage client records to track batch spend by project or cost center. Attach a client_id to a batch to group its usage, cap it with a client budget, and send its events to a client webhook. API keys stay scoped to your organization.
POST /v1/batch/clients: create a clientGET /v1/batch/clients: list all clientsGET /v1/batch/clients/{clientId}: get a single clientPATCH /v1/batch/clients/{clientId}: update a clientDELETE /v1/batch/clients/{clientId}: soft-delete a client
- Pricing
| Metric | Value |
|---|---|
| Cost | FREE: client management does not consume credits |
Create Client
List Clients
GET /v1/batch/clients: accepts limit (default 50) and offset (default 0).
Get / Update / Delete
Standard REST operations on GET/PATCH/DELETE /v1/batch/clients/{clientId}. Delete is a soft-delete (marks deleted_at).
Status Codes
200/201
400
401
404
429
Best Practices
Create a client per customer
Create a client per customer
Create one client record per customer, project, or cost center and attach its client_id to related batches to track costs. API keys remain scoped to the authenticated organization; keep them private. You may deliver or resell lawfully obtained results to clients under the Terms: Data Use Rights.
Set credit limits per client
Set credit limits per client
Use Credit Budgets with a client scope to cap spend. View aggregated usage through Client Metrics.
Was this page helpful?
We value your feedback.