Integraties
Verbind Leadsluis met je eigen software
Op dit moment koppel je via onze REST API en webhooks. Push leads automatisch vanuit je eigen systemen en ontvang realtime updates zodra er iets met een lead gebeurt.
Aan de slag
Zo maak je verbinding
Genereer een API-key
Maak in het Leadsluis-dashboard een API-key aan. Die gebruik je als bearer-token bij elke aanvraag.
Push je leads via de API
Stuur leads met een POST naar /leads. De API is REST, spreekt JSON en ondersteunt filteren en pagineren.
Ontvang events via webhooks
Configureer een webhook-URL en ontvang realtime meldingen zodra een lead wordt aangemaakt, gepubliceerd of verkocht.
Zo communiceer je
Hoe de koppeling werkt
Bearer-authenticatie
Elke aanvraag stuur je met je API-key in de Authorization-header. Keys beheer je in het dashboard.
REST + JSON
Alle endpoints leven onder api.leadsluis.nl/api/v1/integrations en spreken JSON.
Pagineren & filteren
Lijst-endpoints ondersteunen paginering en filters op status, categorie, locatie en datum.
Duidelijke foutcodes
401 bij een ongeldige key, 404 als iets niet bestaat en 422 bij een validatiefout.
Ondertekende webhooks
Elke webhook is met HMAC-SHA256 ondertekend via de X-Webhook-Signature-header, zodat je de afzender kunt verifiëren.
Automatische retries
Mislukt een aflevering? Dan proberen we het tot 5 keer opnieuw met exponentiële back-off. Dubbele afleveringen herken je aan X-Webhook-Id.
Over de documentatie
De referenties hieronder worden rechtstreeks uit onze OpenAPI-specificatie geladen, dus ze zijn altijd actueel. Per endpoint zie je welke velden je meestuurt, welke antwoorden je terugkrijgt en welke statuscodes mogelijk zijn.
REST API
API-referentie
Webhooks