DocsAPI Reference

API Reference

Complete Lead Distro AI API reference. Ingest leads via REST endpoints with field validation, signed webhooks, authentication, rate limits, and full example requests for every lead distribution endpoint.

Lead Ingest API

Send leads into Lead Distro AI using a simple POST request. Leads are validated against your campaign's field mapping, checked against inbound filters and suppression lists, then distributed to buyers automatically.

Endpoint

POST https://www.leaddistro.ai/api/v1/ingest

Authentication

Include your supplier's API key in the `x-api-key` header. You can find this in the supplier detail page.

x-api-key: your_supplier_api_key

Request Body

Send a JSON body with the required system fields and any custom fields defined in your campaign's field mapping.

Field	Type	Required	Description
flo_campaign_id	string	Yes	The campaign ID to route this lead to.
flo_supplier_id	string	Yes	The supplier ID sending this lead.
first_name	string	Yes	Lead's first name.
last_name	string	Yes	Lead's last name.
phone	string	Yes	Lead's phone number.
email	string	Yes	Lead's email address.
state	string	No	Two-letter US state code (used for state-based routing).
...custom fields	varies	Depends	Any additional fields defined in your campaign's field mapping.

Example Request

curl -X POST https://www.leaddistro.ai/api/v1/ingest \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_supplier_api_key" \
  -d '{
    "flo_campaign_id": "campaign_abc123",
    "flo_supplier_id": "supplier_xyz789",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "5551234567",
    "email": "john@example.com",
    "state": "TX"
  }'

Response

On success the API returns the created lead with its assigned buyer and status.

{
  "data": {
    "id": "lead_id",
    "status": "ACCEPTED",
    "buyer_id": "buyer_abc",
    "campaign_id": "campaign_abc123"
  }
}

If no buyer is available (all caps filled, no matching state filters, etc.), the lead status will be UNMATCHED instead of ACCEPTED.

Ping-Post Mode

For ping-post campaigns, use the separate ping endpoint to check buyer availability before committing the lead.

POST https://www.leaddistro.ai/api/v1/ping

The ping endpoint returns available buyers and their bid prices without creating a lead. You then post the full lead to the ingest endpoint with the chosen buyer.

If you have any questions, send us an email at support@leaddistro.ai

Getting Started Campaigns