Clay logo

LeadMagic has made more than one billion API calls with Clay and won The Unstoppable Wheel award.

Recap
LeadMagicDocs

Client Management

Create and manage client records to track batch spend by project or cost center, with per-client budgets and webhooks.

POSThttps://api.leadmagic.io/v1/batch/clients
Try 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 client
  • GET /v1/batch/clients: list all clients
  • GET /v1/batch/clients/{clientId}: get a single client
  • PATCH /v1/batch/clients/{clientId}: update a client
  • DELETE /v1/batch/clients/{clientId}: soft-delete a client
MetricValue
CostFREE: client management does not consume credits

Create Client

name
string
required
Unique client identifier (slug). Lowercase, alphanumeric with hyphens.
display_name
string
Human-readable display name.
contact_email
string
Contact email for notifications.
billing_rate
number
Optional billing rate for this client.
notes
string
Internal notes.
industry
string
Industry classification.
website
string
Client website.
phone
string
Phone number.
address
object
Physical address object.
custom_fields
object
Arbitrary custom fields.
client_id
string
UUID.
name
string
Client slug.
display_name
string
Display name.
contact_email
string
Contact email.
created_at
string
ISO 8601.

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

OK

400

Bad Request

401

Unauthorized

404

Not Found

429

Rate Limit

Best Practices

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.

Use Credit Budgets with a client scope to cap spend. View aggregated usage through Client Metrics.