DocsAPI Reference

API Reference

Ingest leads via our REST API with full field validation.

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://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://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://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