Insertion API

Get Lead

Fetches a single lead by either the AdBuy UUID (leads.id) or the partner-supplied external_lead_id. Same identifier policy as Update Lead — whichever you have on hand works. Cross-account lookups return 404 not_found.

Endpoint

GET/api/v1/insertion/leads/:id

Authentication

Same as Create Lead. GET requires the leads:read scope on the API key.

Path Parameters

Name	Type	Description
`id`required	string	Either the AdBuy lead UUID (leads.id) OR the partner-supplied external_lead_id. Scoped to your account.

Response

Response Schema

{
  "ok": true,
  "lead": {
    "id": "uuid",
    "account_id": "uuid",
    "campaign_id": 123,
    "external_lead_id": "uuid-from-partner",
    "phone": "+15551234567",
    "email": "lead@example.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "source": "...",
    "source_form_url": "...",
    "tcpa_consent": true,
    "tcpa_consent_text": "...",
    "tcpa_consent_timestamp": "2024-01-15T10:30:00Z",
    "custom_fields": { },
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Example

cURL (Bearer) — by UUID

curl "https://api.adbuy.ai/api/v1/insertion/leads/f6b1d3c0-1234-4abc-9def-0123456789ab" \
  -H "Authorization: Bearer sk_live_..."

cURL (Bearer) — by external_lead_id

curl "https://api.adbuy.ai/api/v1/insertion/leads/partner-side-id-12345" \
  -H "Authorization: Bearer sk_live_..."