Op deze pagina staat hoe LeadForge een webhook aflevert: wanneer een aflevering als gelukt telt, wanneer LeadForge het opnieuw probeert en wanneer een adres vanzelf uitgaat. Zo kun je je ontvanger erop inrichten.
Wat als gelukt telt
Antwoord binnen 8 seconden met een status in de 200-reeks, bijvoorbeeld 200 of 204. Duurt de verwerking langer, antwoord dan eerst en verwerk daarna.
| Antwoord van je ontvanger | Wat LeadForge doet |
|---|---|
| 2xx | Gelukt. Geen nieuwe poging. |
| 3xx, een doorverwijzing | Mislukt, en geen nieuwe poging. De fout is: HTTP 302: een doorverwijzing wordt niet gevolgd, geef het eindadres op (met de status die je ontvanger gaf). |
| 4xx, behalve 429 | Mislukt, en geen nieuwe poging. |
| 429 | Mislukt, en LeadForge probeert het opnieuw. |
| 5xx | Mislukt, en LeadForge probeert het opnieuw. |
| Geen antwoord binnen 8 seconden | Mislukt, en LeadForge probeert het opnieuw. |
| Netwerkfout | Mislukt, en LeadForge probeert het opnieuw. |
Pogingen
Een aflevering krijgt hoogstens 3 pogingen:
- Meteen.
- 1 seconde na de eerste poging.
- 4 seconden na de tweede poging.
Elke poging mag 8 seconden duren. Bij elke poging staat in x-leadforge-signature een nieuwe t; de body en het aflever-id blijven gelijk. Herken dubbele afleveringen dus aan x-leadforge-delivery of het id in de body.
Voor elke poging controleert LeadForge opnieuw of het adres een openbare website is. Is de website niet te vinden, dan telt dat als mislukte poging en volgt een nieuwe. Wijst het adres naar een niet-openbaar adres, dan stopt de aflevering meteen. De fout begint dan met adres geweigerd: en noemt de reden.
Goed om te weten
Automatisch uitzetten
Zijn de laatste 20 afleveringen naar een adres allemaal mislukt, dan zet LeadForge het adres zelf uit. Er gaat daarna niets meer naartoe. Op Instellingen > Webhooks staat het adres dan op Uit.
Heb je de ontvanger gerepareerd, klik dan op Aanzetten. De telling begint dan opnieuw, zodat het adres niet meteen weer uitgaat.
Testaflevering
Met de knop Test bij een adres stuur je een testaflevering. Zo zie je of je ontvanger bereikbaar is en de handtekening goed controleert.
- Test werkt alleen als het adres aan staat. Anders zie je Zet het adres eerst aan.
- De test gaat alleen naar dat ene adres.
- De test gebruikt de eerste gebeurtenis die het adres volgt, en heeft dezelfde headers, handtekening en pogingen als een echte aflevering.
- De gegevens zijn verzonnen en hebben altijd
test: true. Laat je ontvanger daarop letten, zodat er geen nep-lead in je CRM komt. - Na de test meldt het scherm of hij is aangekomen, met de status, of na hoeveel pogingen hij mislukte en waarom. In Laatste afleveringen staat hij met (test).
Testgegevens
Bij lead.created:
{
"id": "<aflever-id>",
"event": "lead.created",
"createdAt": "2026-11-09T10:15:00.000Z",
"data": {
"test": true,
"message": "Dit is een testaflevering van LeadForge. Er is niets echt gebeurd.",
"leadId": "test_1a2b3c4d",
"firstName": "Sanne",
"lastName": "de Vries",
"linkedIn": "https://www.linkedin.com/in/voorbeeld",
"source": "test"
}
}
Bij conversation.label_changed is data:
{
"test": true,
"message": "Dit is een testaflevering van LeadForge. Er is niets echt gebeurd.",
"conversationId": "test_1a2b3c4d",
"from": "new",
"to": "interested",
"name": "Sanne de Vries"
}
Bij de andere gebeurtenissen is data:
{
"test": true,
"message": "Dit is een testaflevering van LeadForge. Er is niets echt gebeurd.",
"conversationId": "test_1a2b3c4d",
"name": "Sanne de Vries"
}
De acht tekens na test_ komen uit het id van het webhook-adres.