Lead ingest API

The lead-ingest API is what sellers (lead sources, publishers, affiliate networks) call to push new leads into the platform. Sellers authenticate with a sk_live_… key — see Authentication.

Note

This page is a stub — the full payload schema is being ported from the internal Features Documentation. If you need fields that aren’t covered here yet, the canonical reference is the seller integration guide your account manager shared during onboarding.

Direct POST

POST /api/v1/leads
Authorization: Bearer sk_live_…
Content-Type: application/json
Idempotency-Key: <uuid>

{
  "campaignId": "c1…",
  "pii": {
    "firstName": "Jane",
    "lastName":  "Doe",
    "email":     "[email protected]",
    "phone":     "+15551234567"
  },
  "address": { "state": "TX", "zip": "78701" },
  "consent": {
    "trustedFormCertUrl": "https://cert.trustedform.com/…",
    "tcpaConsent": true,
    "consentTimestamp": "2026-05-13T15:04:05Z",
    "consentIp": "203.0.113.42"
  },
  "attribution": { "fbclid": "…", "gclid": "…" }
}

Ping / post

Two-phase submission for real-time bidding: send anonymised data with POST /api/v1/leads/ping, receive bids, then commit with POST /api/v1/leads/post/{pingId} carrying the full PII.

See Authentication for error envelope and rate limit details.