---
title: "Send a qualified buyer-intent enquiry (lead) to a listing or category"
method: POST
path: "/api/lead"
---

# Send a qualified buyer-intent enquiry (lead) to a listing or category

`POST /api/lead`

## Request

- Base URL: `https://theagentsindex.com`
- URL: `https://theagentsindex.com/api/lead`
- Auth: none declared

A buyer-intent enquiry routed to the listing owner (or a category's providers). Keyless and CSRF-free when sent as application/json. The quality gate requires consent=true, a real name, a permanent (non-disposable) email, a message of at least 20 chars, and a target (listingSlug OR categorySlug). The same (email + target) within 7 days is idempotent (200, duplicate:true). Nothing here changes a listing's rank, tier or copy.

## Request body

- LeadInput
  - `name` string, required
  - `email` string, required: A permanent (non-disposable) email.
  - `message` string, required: The enquiry — real demand, at least 20 chars.
  - `consent` union, required: Must be truthy — the sender agreed their details go to the provider(s).
    - boolean
    - string
  - `listingSlug` string: Target listing slug (this OR categorySlug is required).
  - `categorySlug` string: Target category slug (this OR listingSlug is required).
  - `company` string
  - `source` string

## Response `200`

Accepted (routed or deduplicated): { ok:true, delivered }.

- object

## Other responses

- `400`: Rejected by the quality gate: { ok:false, error } (e.g. no_consent, thin_message, bad_email, no_target).

---

[API](https://skmtc.dev/theagentsindex/apis/the-agents-index-machine-api.md) · [All operations](https://skmtc.dev/theagentsindex/apis/the-agents-index-machine-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theagentsindex/apis/the-agents-index-machine-api/revisions/1b44b8931dae?raw)