Webhooks

Webhooks lader dit eget system vide besked i det øjeblik, noget sker i Zippendo: en forsendelse oprettes eller sendes, en ordre ændres, eller en pakke får en ny trackinghændelse. Zippendo sender en besked til en adresse (URL) på din server. Du sætter dem op under Webhooks i Indstillinger. Modtagersiden bliver som regel bygget af en udvikler. Det er ikke de andre slags webhooks, du kan støde på i Zippendo:

Type	Hvor	Retning
Webhooks (denne side)	Indstillinger → Webhooks	Zippendo → din server
Tracking-webhooks fra transportører	På en transportør	Transportør → Zippendo. Se Tracking-webhooks fra transportører.
Shopify-ordrewebhooks	På en Shopify-ordrekanal	Shopify → Zippendo. Zippendo sætter dem op. Se Shopify-indstillinger.
WooCommerce-ordrewebhooks	På en WooCommerce-ordrekanal	WooCommerce → Zippendo. Se Forbind WooCommerce.
Ordrer fra en egen kanal	På en egen ordrekanal	Dit system → Zippendo. Se API til egen kanal.

Hvis du vil sende hændelser til Slack, Klaviyo og lignende apps uden at bygge noget, så brug Forbind Slack, Klaviyo og andre apps i stedet. Rundtur i Indstillinger: Indstillinger, team og brands. Hvad hver besked indeholder: Kom i gang med webhooks. Beskeder, der ikke kommer frem: Webhook-leveringer fejler.

Webhooks er inkluderet i alle planer: Free op til 5 webhooks, Standard op til 10, Growth op til 25, Pro op til 100, Enterprise ubegrænset.

Her finder du dem

Åbn organisationsmenuen nederst i sidemenuen, klik på Administrer og derefter på fanen Webhooks. Knappen til at oprette en er Tilføj webhook øverst til højre.

Fanen Webhooks i Indstillinger med én webhook på listen og Tilføj webhook i overskriften — Webhook-listen: navn, URL, hændelser, status og handlinger

Webhook-listen

Kolonne	Hvad den viser
Navn	Det navn, du har skrevet.
Brand	Webhookens brand, eller tom, hvis den dækker hele organisationen. Vises kun, hvis din organisation har brands.
URL	Adressen, Zippendo sender til.
Hændelser	De første to hændelser, den sender, for eksempel Forsendelse oprettet. Resten er skjult.
Status	Aktiv eller Inaktiv.
Oprettet	Hvornår den blev oprettet.

Hver række har Leveringslog, Send test, Rediger og Slet. Et klik på rækken åbner Rediger webhook. Du finder en webhook ved at klikke på Filtre over listen. Du kan søge på navn, vælge Aktiv (Ja eller Nej) og, hvis du har brands, et Brand. Klik på Tilføj filtre for at bruge dem. Mere om lister: Søgning og filtre. Hvis du endnu ikke har nogen webhooks, viser listen Ingen webhooks og en knap, Opret din første webhook.

Opret en webhook

Åbn vinduet

Klik på Tilføj webhook, eller på Opret din første webhook, når listen er tom. Vinduet Opret webhook åbnes.

Navn og adresse

Udfyld Navn * og Endpoint-URL *. Brug en adresse, der starter med https://.

Vælg hændelserne

Sæt flueben ved de hændelser, du vil have, eller klik på Vælg alle. Sæt flueben ved Tracking opdateret, hvis dit system skal have hver eneste trackingscanning.

Opret den

Klik på Opret webhook. Du ser Webhook oprettet.

Vinduet Opret webhook med Navn, Endpoint-URL, Vælg alle og afkrydsningsfelterne for forsendelseshændelser — Opret webhook: Navn, Endpoint-URL og hændelserne

Felt	Påkrævet	Hvad du skal skrive
Navn *	Ja	Et navn, du kan genkende, for eksempel “Ordrenotifikationer”. Op til 100 tegn.
Endpoint-URL *	Ja	Den fulde adresse på din server, for eksempel `https://example.com/webhooks`.
Brand	Nej	Vises kun, hvis din organisation har brands. Vælg et brand, og Denne webhook modtager kun dette brands hændelser. Standarden, Intet brand (hele organisationen), modtager alle brands’ hændelser.
Hændelser *	Ja, mindst én	De hændelser, der skal sendes. Se listen nedenfor.

Opret webhook er nedtonet, indtil du har udfyldt navnet, adressen og mindst én hændelse. Hvis oprettelsen fejler med Du har nået grænsen for dit abonnement. Opgrader dit abonnement, eller fjern noget, du ikke længere bruger., så slet en webhook, du ikke længere bruger, eller opgrader dit abonnement.

Hændelserne

Der er ni hændelser i tre grupper. Det tekniske navn i anden kolonne er det, dit system modtager.

Vinduet Opret webhook med flueben ved alle ni hændelser, også Tracking opdateret — Vælg alle sætter flueben ved alle hændelser, også Tracking opdateret

Hændelse	Navn, dit system modtager	Sendes når
Forsendelse oprettet	`shipment.created`	En forsendelse oprettes.
Forsendelse opdateret	`shipment.updated`	En forsendelse ændres.
Forsendelse afsendt	`shipment.dispatched`	En forsendelse sendes og har sin label.
Forsendelse annulleret	`shipment.cancelled`	En forsendelse slettes.
Forsendelsesfejl	`shipment.error`	Afsendelsen af en forsendelse til transportøren fejler.
Ordre oprettet	`order.created`	En ordre oprettes via API’et.
Ordre opdateret	`order.updated`	En ordre ændres i Zippendo eller via API’et.
Ordre annulleret	`order.cancelled`	En ordre slettes i Zippendo eller via API’et.
Tracking opdateret	`tracking.updated`	En pakke får en ny trackinghændelse.

Ordrer, der kommer ind fra en forbundet webshop, og de ændringer, webshoppen sender senere, sender ikke ordrehændelser. Dit system hører stadig om dem gennem forsendelseshændelserne: Zippendo opretter en forsendelse for hver ordre, den importerer. Send test sender en testbesked, der hedder webhook.test. Du kan ikke sætte flueben ved den som hændelse.

Rediger eller sæt en webhook på pause

Klik på rækken, eller på Rediger, for at åbne Rediger webhook. Den har de samme felter som Opret webhook, plus Aktiv. Klik på Gem ændringer, når du er færdig.

Vinduet Rediger webhook med Navn, Endpoint-URL, et afkrydsningsfelt for Aktiv og hændelserne — Rediger webhook: de samme felter, plus Aktiv

Fjern flueben ved Aktiv for at stoppe afsendelsen uden at slette webhooken eller dens Leveringslog. Kolonnen Status viser så Inaktiv. Sæt flueben igen for at starte afsendelsen.

Leveringslog

Leveringslog på en række viser de seneste forsøg på at levere til den adresse.

Kolonne	Hvad den viser
Hændelse	Den hændelse, der blev sendt, for eksempel `shipment.created` eller `webhook.test`.
Status	Den statuskode, din server svarede med, grøn ved succes og rød ved fejl, eller N/A, hvis der ikke var noget svar.
Varighed	Hvor lang tid din server brugte på at svare.
Forsøg	Hvilket forsøg det var.
Fejl	Hvad der gik galt, hvis noget.
Tidspunkt	Hvornår forsøget blev lavet.

Zippendo venter op til 10 sekunder på, at din server svarer. Hvis den ikke svarer, eller svarer med en fejl, prøver Zippendo igen, i alt op til 5 gange, og venter lidt længere hver gang. Hvert forsøg er en række i loggen.

Send en testbesked

Klik på Send test på en række. Du ser Testhændelse sendt. Testbeskeden ser sådan ud:

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

Åbn Leveringslog for at se, om din server modtog den.

Slet en webhook

Klik på Slet på en række. Slet webhook beder dig skrive webhookens navn med store bogstaver og derefter klikke på Slet. Webhooken og dens Leveringslog fjernes, og du ser Webhook slettet.

Vinduet Slet webhook med et felt, hvor du skriver navnet for at bekræfte — Slet webhook: skriv navnet med store bogstaver for at bekræfte

Til udviklere: beskedformat og signatur

Hver besked er en POST med en JSON-body { "event", "timestamp", "brandId", "data" } og disse headers:

Header	Værdi
`Content-Type`	`application/json`
`X-Webhook-Signature`	HMAC-SHA256 af den rå body, hex, med webhookens secret som nøgle
`X-Webhook-Event`	Hændelsens navn
`X-Webhook-Id`	Ét ID pr. levering. Hvert nyt forsøg på den samme levering sender det samme ID, så du kan bruge det til at springe dubletter over.

Zippendo opretter secret’en, når du opretter webhooken. Appen viser den ikke: læs den med forespørgslen Get webhook i API-referencen (listeforespørgslen udelader den). Tjek signaturen, før du læser body’en. Et gennemgået eksempel står i Kom i gang med webhooks. Ordrer, der sendes ind i en egen ordrekanal, signeres på samme måde med headeren X-Zippendo-Signature: API til egen kanal.

Svar hurtigt med en 2xx-status, og gør arbejdet bagefter. Brug https://-adresser. Webhooks, der ikke er Aktiv, modtager ingenting.

Relateret

Opret et API-token: dit system spørger Zippendo, i stedet for at Zippendo fortæller dit system noget.
Tracking-webhooks fra transportører: transportører, der sender tracking til Zippendo.
Forbind Slack, Klaviyo og andre apps: du behøver ingen egen server.
Shopify-indstillinger / Forbind WooCommerce: de webshop-webhooks, Zippendo sætter op for dig.

Overblik

Forsendelser

Ordrer og ordrekanaler

Transportører

Tilslut en transportør

Tilslut en integration

Udskrivning

Automatisering

Konto

Søgning og dashboard

API og events

Her finder du dem

Webhook-listen

Opret en webhook

Hændelserne

Rediger eller sæt en webhook på pause

Leveringslog

Send en testbesked

Slet en webhook

Til udviklere: beskedformat og signatur

Relateret

​Her finder du dem

​Webhook-listen

​Opret en webhook

​Hændelserne

​Rediger eller sæt en webhook på pause

​Leveringslog

​Send en testbesked

​Slet en webhook

​Til udviklere: beskedformat og signatur

​Relateret

Her finder du dem

Webhook-listen

Opret en webhook

Hændelserne

Rediger eller sæt en webhook på pause

Leveringslog

Send en testbesked

Slet en webhook

Til udviklere: beskedformat og signatur

Relateret