Een webhook endpoint is geen API-endpoint, ook al lijken ze op elkaar. Het verschil zit in wie het gesprek begint: bij een webhook duwt de server data naar jou, bij een API trek jij eraan.

4 gerelateerde berichten

Definitie webhook endpoint: Een URL die POST-verzoeken ontvangt met event data van een externe dienst ·
Verschil met API: Webhook pusht data (realtime), API pullt data (verzoek) ·
Voorbeeldprovider: Stripe, GitHub, Slack, Twilio

Overzicht

1Bevestigde feiten
  • Een webhook endpoint is een URL die POST-verzoeken ontvangt van een externe dienst (Svix Resources)
  • Webhooks pushen data in realtime, zonder dat jij hoeft te pollen (Theneo)
  • Webhook endpoints moeten verifieerbaar zijn via handtekeningen (Zoom Developer Docs)
2Wat onduidelijk is
  • Of webhooks volledig verouderd raken door alternatieven zoals WebSockets
  • De precieze impact van de Microsoft Teams Connectors deprecatie op de industrie
3Tijdlijn-signaal
  • November 2025: Postman publiceert uitgebreide uitleg over API endpoints (Postman Blog)
4Wat komt hierna
  • Webhook endpoints blijven de standaard voor realtime notificaties, maar alternatieven zoals WebSockets winnen terrein voor continue verbindingen (Redocly)

Vier kernpunten, één patroon: webhook endpoints zijn het simpelste mechanisme om realtime data te ontvangen van externe diensten.

De kern van het verschil: het ene endpoint wacht op een verzoek, het andere wordt actief aangeroepen.

Kenmerk Waarde
Definitie Een webhook endpoint is een URL die POST-verzoeken ontvangt van een externe dienst
Protocol HTTP/HTTPS, meestal POST
Gebruik Realtime notificaties, integraties, automatisering
Verschil met API Webhook pusht data, API pullt data

Wat is het doel van een webhook?

Waarom worden webhooks gebruikt?

  • Webhooks sturen realtime meldingen naar een endpoint zodra een gebeurtenis plaatsvindt (Theneo).
  • Ze vervangen polling: jij hoeft niet steeds te vragen of er iets nieuws is; het systeem stuurt het zelf.
  • Veelvoorkomende events: nieuwe betaling, nieuwe commit, inkomend sms-bericht (Twilio Docs).
Waarom dit belangrijk is

Stel je voor dat je elke seconde een telefoonnummer moet bellen om te vragen of er een bericht is. Dat is API-pulling. Een webhook is alsof de beller jou belt zodra er iets is. Minder belasting, sneller resultaat.

Het implicatie: door push-communicatie besparen webhooks niet alleen bandbreedte, maar ook tijd. Voor toepassingen zoals betalingsverwerking of CI/CD-pipelines is dat essentieel.

Verschil tussen webhook en polling

Polling werkt met een client die herhaaldelijk een API request stuurt. Webhooks werken met een server die een POST-bericht stuurt naar een vooraf ingesteld endpoint (Merge.dev). De winst: geen onnodige verzoeken, directe notificatie.

Wat is een webhook met een voorbeeld?

Voorbeeld: Stripe betalingen

  • Nadat een klant een betaling voltooit, stuurt Stripe een POST-verzoek met de betalingsgegevens naar jouw webhook endpoint (Stripe Docs).
  • Je ontvangt realtime data zonder dat je de Stripe API constant hoeft te pollen.

Voor de gebruiker voelt het alsof de bevestiging direct verschijnt – dat is de kracht van een webhook.

Voorbeeld: GitHub push events

  • Bij elke push of pull request verstuurt GitHub een webhook met info over de commit, auteur en repository.
  • Dat maakt automatisering van CI/CD-triggers mogelijk zonder handmatige tussenkomst.

Deze voorbeelden laten zien hoe webhook endpoints de lijm vormen tussen diensten die anders geen directe verbinding hebben.

Wat is het verschil tussen een webhook en een API-endpoint?

Pull versus push

  • API endpoints werken op pull-basis: jij stuurt een verzoek (GET, POST, PUT, DELETE) en ontvangt een antwoord (Postman Blog).
  • Webhook endpoints werken op push-basis: de server stuurt data zonder dat jij erom vraagt, en gebruikt alleen POST (Svix Resources).

Wie initieert de communicatie

  • Bij een API endpoint is de client de initiator: de app vraagt om data.
  • Bij een webhook endpoint is de server de initiator: de dienst stuurt een event naar jouw URL (Glean).

Wanneer gebruik je een webhook vs een API?

Gebruik een webhook endpoint wanneer je onmiddellijk op de hoogte wilt zijn van een specifieke gebeurtenis. Gebruik een API endpoint wanneer je data opvraagt of een actie uitvoert op verzoek. Webhooks zijn ideaal voor notificaties, API’s voor gestructureerde data-uitwisseling (Moesif Blog).

De conclusie: beide zijn endpoints, maar ze dienen fundamenteel verschillende communicatiepatronen.

Is een webhook een endpoint?

Elke webhook heeft een endpoint

  • Een webhook is per definitie een endpoint: het is een URL die luistert naar inkomende POST-verzoeken (Svix Resources).
  • Zonder een endpoint kan een webhook geen data ontvangen.

Niet elk endpoint is een webhook

  • Endpoints kunnen ook GET-, PUT- of DELETE-verzoeken afhandelen. Webhook endpoints zijn beperkt tot POST en zijn specifiek bedoeld voor eventnotificaties (IBM).
  • Een API endpoint kan meerdere resources bedienen; een webhook endpoint wacht op één type event.

Dus: ja, een webhook is een endpoint, maar met een smalle, duidelijke taak.

Hoe maak ik een webhook endpoint aan?

Stap 1: Kies een server of platform

  • Je kunt een eigen server opzetten met een framework zoals Python (Flask/FastAPI) of Node.js (Express).
  • Of gebruik een platform zoals Webhook.site om snel te testen (Webhook.site).

Stap 2: Maak een endpoint URL

  • Het endpoint moet via HTTPS bereikbaar zijn – de meeste providers eisen dat (Zoom Developer Docs).
  • De URL is uniek en vaak voorzien van een secret om de afzender te verifiëren.

Stap 3: Verwerk de payload

  • Ontvang de JSON-data van het POST-verzoek en verwerk deze in je applicatie.
  • Controleer altijd de authenticiteit via een handtekening of token (Stripe Docs).

Met deze drie stappen sta je in een paar minuten een webhook endpoint te draaien. De grootste uitdaging is vaak het beveiligen tegen spoofing.

Vergelijking: webhook endpoint vs API endpoint

Vijf verschillen, één inzicht: de keuze hangt af van wie de communicatie start.

Aspect Webhook endpoint API endpoint
Initiatief Server (push) Client (pull)
HTTP methode Alleen POST GET, POST, PUT, DELETE
Doel Notificaties bij events Data opvragen/wijzigen
Realtime Direct Afhankelijk van polling
Voorbeeld Stripe betaling Ophalen productlijst

De afweging: kies een webhook endpoint voor gebeurtenisgestuurde notificaties; kies een API endpoint voor gestructureerde data-uitwisseling op verzoek.

Bevestigde feiten vs onduidelijkheden

Bevestigde feiten

  • Een webhook endpoint is een URL die POST-verzoeken ontvangt (Svix Resources).
  • Webhooks worden gebruikt door Stripe, GitHub, Slack, Twilio (Twilio Docs).
  • Webhook endpoints moeten verifieerbaar zijn via handtekeningen (Zoom Developer Docs).

Wat onduidelijk is

  • Of webhooks vervangen worden door WebSockets voor persistente verbindingen.
  • De impact van de Microsoft Teams Connectors deprecatie op de adoptie van webhooks.

Citaten uit de praktijk

“A webhook then seems to be nothing more than a POST-endpoint that expects specific data.”

— Reddit-gebruiker, r/webdev

“A webhook endpoint is a URL that receives webhook event notifications and can trigger an action based on the payload.”

— Svix glossary

“Stripe can push realtime event data to your webhook endpoint when events happen in your account.”

— Stripe documentatie

Deze stemmen uit de community en officiële bronnen bevestigen dat webhook endpoints weliswaar simpel zijn, maar een krachtig mechanisme voor realtime integratie.

Samenvatting

Een webhook endpoint is een simpele URL die POST-verzoeken ontvangt en daarmee realtime notificaties mogelijk maakt zonder polling. Het verschil met een API endpoint is fundamenteel: push versus pull. Voor ontwikkelaars die snel willen reageren op events – van betalingen tot commits – blijft het webhook endpoint de meest efficiënte oplossing. Voor de Nederlandse markt, waar platforms als Mollie en Bunq webhooks gebruiken, is het begrijpen van dit concept essentieel om moderne integraties te bouwen.

Gerelateerde lectuur: Webhook Endpoint · Webhook vs Endpoint

Aanvullende bronnen

docs.api.video

Net zoals een webhook endpoint een manier is om real-time data te ontvangen, legt wat een API precies is uit hoe twee systemen via een API met elkaar kunnen communiceren.

Mis deze niet

Veelgestelde vragen

Wat is het verschil tussen een webhook en een callback?

Een callback is een functie in code; een webhook is een URL die een extern systeem aanstuurt bij een event. Ze lijken op elkaar, maar een callback werkt binnen dezelfde applicatie, een webhook tussen verschillende systemen.

Hoe beveilig ik een webhook endpoint?

Gebruik een geheime sleutel om de handtekening van het bericht te verifiëren, zoals Stripe en Zoom voorschrijven (Zoom Developer Docs).

Kan ik een webhook endpoint testen met Webhook.site?

Ja, Webhook.site genereert een unieke URL die alle inkomende verzoeken toont, perfect om te testen (Webhook.site).

Wat is een webhook endpoint URL?

Het is de URL waar jouw applicatie POST-verzoeken ontvangt van externe diensten, bijvoorbeeld https://jouwdomein.nl/webhook/stripe.

Zijn webhooks veilig?

Ja, mits je HTTPS gebruikt en de afzender verifieert via een handtekening. Zonder verificatie kan iedereen data naar je endpoint sturen.

Hoe lang duurt het voordat een webhook aankomt?

Meestal binnen enkele seconden, afhankelijk van de netwerklatentie en de belasting van de provider.

Wat gebeurt er als een webhook endpoint niet beschikbaar is?

De meeste diensten proberen het opnieuw (retry) of loggen de mislukte delivery. Het is cruciaal om je endpoint stabiel te houden.