Leads
Contact-form leads from your public page
Leads arrive via the lead.created event; these endpoints let you backfill and reconcile. A lead is a raw enquiry from the public contact form — not yet a configured submission. Read-only here: leads are created by the public form and advance through their lifecycle in the app.
GET /leads
Query params: status (new|contacted|closed), limit, cursor. Newest first.
curl -H "Authorization: Bearer $WF_API_KEY" \
"https://app.winfactor.app/api/v1/leads?status=new"{
"data": [
{ "id": "k91…", "name": "Peter Jansen", "email": "[email protected]",
"phone": "+31 6 …", "message": "Looking for 6 windows for a renovation…",
"status": "new", "createdAt": 1781100202000 }
],
"nextCursor": null
}| Field | Type | Notes |
|---|---|---|
id | string | Lead ID |
name | string | Submitted name |
email | string | Submitted email |
phone | string | null | Optional |
message | string | The enquiry text |
status | string | new → contacted → closed |
createdAt | integer | Unix ms |
GET /leads/{id}
A single lead — identical field shape to a list item, not wrapped in data. Returns 404 not_found for unknown IDs or IDs belonging to another organization.