Webhooks

Met Webhooks laat je eigen systeem op het moment zelf weten dat er iets gebeurt in Zippendo: een zending wordt aangemaakt of verzonden, een bestelling verandert, of een pakket krijgt een nieuwe trackinggebeurtenis. Zippendo stuurt een bericht naar een adres (URL) op je server. Je stelt ze in onder Webhooks bij Instellingen; de ontvangende kant wordt meestal door een ontwikkelaar gebouwd. Dit zijn niet de andere soorten webhooks die je in Zippendo tegenkomt:

Soort	Waar	Richting
Webhooks (deze pagina)	Instellingen → Webhooks	Zippendo → je server
Track-&-tracewebhooks van vervoerders	Bij een vervoerder	Vervoerder → Zippendo. Zie Tracking-webhooks van vervoerders.
Bestelwebhooks van Shopify	Bij een Shopify-verkoopkanaal	Shopify → Zippendo. Zippendo stelt ze in. Zie Shopify-instellingen.
Bestelwebhooks van WooCommerce	Bij een WooCommerce-verkoopkanaal	WooCommerce → Zippendo. Zie WooCommerce koppelen.
Bestellingen van eigen kanalen	Bij een eigen verkoopkanaal	Je systeem → Zippendo. Zie API voor eigen kanalen.

Om gebeurtenissen naar Slack, Klaviyo en vergelijkbare apps te sturen zonder iets te bouwen, gebruik je in plaats daarvan Slack, Klaviyo en andere apps koppelen. Rondleiding door Instellingen: Instellingen, team en merken. Wat elk bericht bevat: Snelstart voor webhooks. Berichten die niet aankomen: Mislukte webhook-leveringen.

Webhooks zijn inbegrepen bij elk abonnement: Free tot 5 webhooks, Standard tot 10, Growth tot 25, Pro tot 100, Enterprise onbeperkt.

Waar je het vindt

Open het organisatiemenu onderaan de zijbalk, klik op Beheren en dan op het tabblad Webhooks. De knop om er een aan te maken is Webhook toevoegen rechtsboven.

Tabblad Webhooks bij Instellingen met één webhook in de lijst en Webhook toevoegen in de kop — De lijst Webhooks: naam, URL, gebeurtenissen, status en acties

De lijst Webhooks

Kolom	Wat het toont
Naam	De naam die je hebt ingevoerd.
Merk	Het merk van de webhook, of leeg als hij de hele organisatie dekt. Alleen zichtbaar als je organisatie merken heeft.
URL	Het adres waar Zippendo naartoe stuurt.
Gebeurtenissen	De eerste twee gebeurtenissen die hij verstuurt, bijvoorbeeld Zending aangemaakt; de rest is ingeklapt.
Status	Actief of Inactief.
Aangemaakt	Wanneer hij is aangemaakt.

Elke rij heeft Afleverlog, Test verzenden, Bewerken en Verwijderen. Klikken op de rij opent Webhook bewerken. Om een webhook te vinden, klik je boven de lijst op Filters. Je kunt zoeken op naam, Actief kiezen (Ja of Nee) en, als je merken hebt, een Merk. Klik op Filters toevoegen om toe te passen. Meer over lijsten: Zoeken en filters. Zonder webhooks toont de lijst Geen webhooks en een knop Je eerste webhook aanmaken.

Een webhook aanmaken

Het venster openen

Klik op Webhook toevoegen, of op Je eerste webhook aanmaken als de lijst leeg is. Het venster Webhook aanmaken gaat open.

Naam en adres

Vul Naam * en Endpoint-URL * in. Gebruik een adres dat begint met https://.

De gebeurtenissen kiezen

Vink de gebeurtenissen aan die je wilt, of klik op Alles selecteren. Vink Track & trace bijgewerkt aan als je systeem elke trackingscan nodig heeft.

Aanmaken

Klik op Webhook aanmaken. Je ziet Webhook aangemaakt.

Veld	Verplicht	Wat je invult
Naam *	Ja	Een naam die je herkent, zoals “Bestelmeldingen”. Maximaal 100 tekens.
Endpoint-URL *	Ja	Het volledige adres op je server, zoals `https://example.com/webhooks`.
Merk	Nee	Alleen zichtbaar als je organisatie merken heeft. Kies een merk en Deze webhook ontvangt alleen gebeurtenissen van dit merk. De standaard, Geen merk (hele organisatie), ontvangt de gebeurtenissen van elk merk.
Gebeurtenissen *	Ja, minstens één	De gebeurtenissen die worden verstuurd. Zie de lijst hieronder.

Webhook aanmaken blijft grijs tot je de naam, het adres en minstens één gebeurtenis hebt ingevuld. Mislukt het aanmaken met Je hebt de limiet van je abonnement bereikt. Upgrade je abonnement of verwijder iets wat je niet meer gebruikt., verwijder dan een webhook die je niet meer gebruikt of upgrade je abonnement.

De gebeurtenissen

Er zijn negen gebeurtenissen, in drie groepen. De technische naam in de tweede kolom is wat je systeem ontvangt.

Venster Webhook aanmaken met alle negen gebeurtenissen aangevinkt, inclusief Track & trace bijgewerkt — Alles selecteren vinkt elke gebeurtenis aan, inclusief Track & trace bijgewerkt

Gebeurtenis	Naam die je systeem ontvangt	Verstuurd wanneer
Zending aangemaakt	`shipment.created`	Een zending wordt aangemaakt.
Zending bijgewerkt	`shipment.updated`	Een zending wordt gewijzigd.
Zending verzonden	`shipment.dispatched`	Een zending wordt verzonden en heeft zijn verzendlabel.
Zending geannuleerd	`shipment.cancelled`	Een zending wordt verwijderd.
Fout bij zending	`shipment.error`	Het verzenden van een zending naar de vervoerder mislukt.
Bestelling aangemaakt	`order.created`	Een bestelling wordt aangemaakt via de API.
Bestelling bijgewerkt	`order.updated`	Een bestelling wordt gewijzigd in Zippendo of via de API.
Bestelling geannuleerd	`order.cancelled`	Een bestelling wordt verwijderd in Zippendo of via de API.
Track & trace bijgewerkt	`tracking.updated`	Een pakket krijgt een nieuwe trackinggebeurtenis.

Bestellingen die binnenkomen uit een gekoppelde webshop, en de wijzigingen die de webshop later stuurt, verzenden geen bestelgebeurtenissen. Je systeem hoort er nog steeds van via de zendinggebeurtenissen: Zippendo maakt voor elke bestelling die het importeert een zending aan. Test verzenden verstuurt een testbericht met de naam webhook.test. Je kunt het niet als gebeurtenis aanvinken.

Een webhook bewerken of pauzeren

Klik op de rij, of op Bewerken, om Webhook bewerken te openen. Het heeft dezelfde velden als Webhook aanmaken, plus Actief. Klik op Wijzigingen opslaan als je klaar bent.

Venster Webhook bewerken met Naam, Endpoint-URL, een selectievakje Actief en de gebeurtenissen — Webhook bewerken: dezelfde velden, plus Actief

Haal het vinkje bij Actief weg om te stoppen met verzenden zonder de webhook of zijn Afleverlog te verwijderen. De kolom Status toont dan Inactief. Vink het weer aan om te beginnen met verzenden.

Afleverlog

Afleverlog bij een rij toont de laatste pogingen om bij dat adres af te leveren.

Kolom	Wat het toont
Gebeurtenis	De gebeurtenis die is verstuurd, zoals `shipment.created` of `webhook.test`.
Status	De statuscode waarmee je server antwoordde, groen bij succes en rood bij een fout, of n.v.t. als er geen antwoord was.
Duur	Hoe lang je server erover deed om te antwoorden.
Poging	Welke poging dit was.
Fout	Wat er misging, indien iets.
Tijd	Wanneer de poging werd gedaan.

Zippendo wacht maximaal 10 seconden tot je server antwoordt. Antwoordt hij niet, of met een fout, dan probeert Zippendo het opnieuw, in totaal maximaal 5 keer, en wacht daarbij telkens iets langer. Elke poging is een rij in het log.

Een testbericht verzenden

Klik bij een rij op Test verzenden. Je ziet Testgebeurtenis verzonden. Het testbericht ziet er zo uit:

{
  "event": "webhook.test",
  "timestamp": "2026-06-22T09:30:00.000Z",
  "data": {
    "webhookId": "cm9x2k4lq0001",
    "message": "This is a test event from Zippendo"
  }
}

Open Afleverlog om te zien of je server het heeft ontvangen.

Een webhook verwijderen

Klik bij een rij op Verwijderen. Webhook verwijderen vraagt je de naam van de webhook in hoofdletters te typen en dan op Verwijderen te klikken. De webhook en zijn Afleverlog worden verwijderd en je ziet Webhook verwijderd.

Venster Webhook verwijderen met een veld om de naam te typen ter bevestiging — Webhook verwijderen: typ de naam in hoofdletters om te bevestigen

Voor ontwikkelaars: berichtindeling en handtekening

Elk bericht is een POST met een JSON-body { "event", "timestamp", "brandId", "data" } en deze headers:

Header	Waarde
`Content-Type`	`application/json`
`X-Webhook-Signature`	HMAC-SHA256 van de ruwe body, hex, met het secret van de webhook als sleutel
`X-Webhook-Event`	De naam van de gebeurtenis
`X-Webhook-Id`	Eén ID per aflevering. Elke nieuwe poging van dezelfde aflevering stuurt hetzelfde ID, zodat je het kunt gebruiken om duplicaten over te slaan.

Zippendo maakt het secret aan als je de webhook aanmaakt. De app toont het niet: lees het met het verzoek Get webhook in de API-referentie (het verzoek voor de lijst laat het weg). Controleer de handtekening voordat je de body leest. Een uitgewerkt voorbeeld staat in de Snelstart voor webhooks. Bestellingen die naar een eigen verkoopkanaal worden gepusht, worden op dezelfde manier ondertekend, met een X-Zippendo-Signature-header: API voor eigen kanalen.

Antwoord snel met een 2xx-status en doe het werk daarna. Gebruik https://-adressen. Webhooks die niet Actief zijn, ontvangen niets.

Gerelateerd

Een API-token aanmaken: je systeem vraagt het aan Zippendo, in plaats van dat Zippendo het aan je systeem vertelt.
Tracking-webhooks van vervoerders: vervoerders die tracking naar Zippendo sturen.
Slack, Klaviyo en andere apps koppelen: geen eigen server nodig.
Shopify-instellingen / WooCommerce koppelen: de webshopwebhooks die Zippendo voor je instelt.

Overzicht

Zendingen

Bestellingen en verkoopkanalen

Vervoerders

Een vervoerder koppelen

Een integratie koppelen

Printen

Automatisering

Account

Zoeken en dashboard

API en events

Waar je het vindt

De lijst Webhooks

Een webhook aanmaken

De gebeurtenissen

Een webhook bewerken of pauzeren

Afleverlog

Een testbericht verzenden

Een webhook verwijderen

Voor ontwikkelaars: berichtindeling en handtekening

Gerelateerd

​Waar je het vindt

​De lijst Webhooks

​Een webhook aanmaken

​De gebeurtenissen

​Een webhook bewerken of pauzeren

​Afleverlog

​Een testbericht verzenden

​Een webhook verwijderen

​Voor ontwikkelaars: berichtindeling en handtekening

​Gerelateerd

Waar je het vindt

De lijst Webhooks

Een webhook aanmaken

De gebeurtenissen

Een webhook bewerken of pauzeren

Afleverlog

Een testbericht verzenden

Een webhook verwijderen

Voor ontwikkelaars: berichtindeling en handtekening

Gerelateerd