Nieuwe lead aanmaken
Creates a customer and work item (and an address when one is supplied) in one call, linked together automatically. Address is optional: lead sources like Meta/Facebook Lead Ads collect only name/email/phone, so a lead with no street/postalCode/city is created address-less. Photos are optional: pass publicly downloadable https URLs in photoUrls (max 10) and they are downloaded and attached to the lead as assets. Photo ingestion is best-effort — failures never fail the lead and are reported per URL in the photos field of the response. Customers are deduplicated: when a non-archived customer in the brand matches the submitted email (case-insensitive) or phone (last 9 digits), the lead is attached to that customer instead of creating a duplicate. On email matches, a missing phone/address on the existing record is backfilled and noted on the lead; phone-matched records are never modified (the submitted email did not match, so it is not trusted).
Autorisaties
Body
Full display name
"Jan de Vries"
"Lekkage badkamer"
"Keizersgracht"
"123"
"A"
"1015 CJ"
"Amsterdam"
"Nederland"
"Jan"
"de Vries"
"+31612345678"
"Installatiebedrijf De Vries B.V."
"Klant meldt waterschade aan het plafond"
Job type / category
"Loodgieter"
low, medium, high, urgent Budget range
"€500 - €1000"
"Graag zo snel mogelijk contact opnemen"
Publicly downloadable https image URLs to attach to the lead (max 10). Downloaded server-side and attached as brand assets; best-effort, so a failed download never fails the lead and is reported per URL in the photos field of the response.
10Respons
"2026-06-17T10:30:45.000Z"
"2026-06-17T10:30:45.000Z"
Brand member who created the record, or null when created by the system (e.g. a lead created through the public API).
null
null
null
null
"WKIabc123def456ghi789jkl"
"BRDabc123def456ghi789jkl"
"CUSabc123def456ghi789jkl"
"Lekkage badkamer"
"Klant meldt waterschade aan het plafond"
Lead-phase statuses (request, contacted, quote_sent, inspection, lost) are returned by GET /leads; job-phase statuses (pending, scheduled, in_progress, completed, cancelled) by GET /work-items.
request, contacted, quote_sent, inspection, lost, pending, scheduled, in_progress, completed, cancelled "request"
low, medium, high, urgent "medium"
"Loodgieter"
null
null
null
null
null
web, phone, chat, referral, other, whatsapp, email, manual "web"
"2026-06-17T10:30:45.000Z"
"ADRabc123def456ghi789jkl"
null
Estimated cost in cents.
null
Final cost in cents.
null
"€500 - €1000"
null
null
null
Populated in the list endpoints (GET /leads, GET /work-items).
Populated in the list endpoints; null when the lead is address-less.
Present only when photoUrls were supplied. One entry per URL, in order.