Webhooks

Webhooks lar ditt eget system vite med en gang noe skjer i Zippendo: en sending opprettes eller sendes, en ordre endres, eller en pakke får en ny sporingshendelse. Zippendo sender en melding til en adresse (URL) på serveren din. Du setter dem opp under Webhooks i Innstillinger. Mottakersiden bygges vanligvis av en utvikler. Dette er ikke de andre typene webhooks du kan møte i Zippendo:

Type	Hvor	Retning
Webhooks (denne siden)	Innstillinger → Webhooks	Zippendo → serveren din
Sporings-webhooks fra transportører	På en transportør	Transportør → Zippendo. Se Sporings-webhooks fra transportører.
Ordre-webhooks fra Shopify	På en Shopify-ordrekanal	Shopify → Zippendo. Zippendo setter dem opp. Se Shopify-innstillinger.
Ordre-webhooks fra WooCommerce	På en WooCommerce-ordrekanal	WooCommerce → Zippendo. Se Koble til WooCommerce.
Ordrer fra egendefinert kanal	På en egendefinert ordrekanal	Ditt system → Zippendo. Se API for egendefinert kanal.

For å sende hendelser til Slack, Klaviyo og lignende apper uten å bygge noe, bruk Koble til Slack, Klaviyo og andre apper i stedet. Omvisning i Innstillinger: Innstillinger, team og merkevarer. Hva hver melding inneholder: Kom i gang med webhooks. Meldinger som ikke kommer frem: Webhook-leveringer feiler.

Webhooks er inkludert i alle planer: Free opptil 5 webhooks, Standard opptil 10, Growth opptil 25, Pro opptil 100, Enterprise ubegrenset.

Hvor du finner det

Åpne organisasjonsmenyen nederst i sidemenyen, klikk Administrer, deretter fanen Webhooks. Knappen for å opprette en er Legg til webhook øverst til høyre.

Fanen Webhooks i Innstillinger med én webhook i listen og Legg til webhook i toppen — Listen Webhooks: navn, URL, hendelser, status og handlinger

Listen Webhooks

Kolonne	Hva den viser
Navn	Navnet du skrev inn.
Merkevare	Merkevaren til webhooken, eller tom hvis den gjelder hele organisasjonen. Vises bare hvis organisasjonen din har merkevarer.
URL	Adressen Zippendo sender til.
Hendelser	De to første hendelsene den sender, for eksempel Sending opprettet. Resten er skjult.
Status	Aktiv eller Inaktiv.
Opprettet	Når den ble opprettet.

Hver rad har Leveringslogg, Send test, Rediger og Slett. Å klikke på raden åpner Rediger webhook. For å finne en webhook klikker du Filtre over listen. Du kan søke etter navn, velge Aktiv (Ja eller Nei) og, hvis du har merkevarer, en Merkevare. Klikk Legg til filtre for å bruke dem. Mer om lister: Søk og filtre. Uten webhooks viser listen Ingen webhooks og en knapp Opprett din første webhook.

Opprett en webhook

Åpne vinduet

Klikk Legg til webhook, eller Opprett din første webhook når listen er tom. Vinduet Opprett webhook åpnes.

Navn og adresse

Fyll ut Navn * og Endpoint URL *. Bruk en adresse som starter med https://.

Velg hendelsene

Kryss av for hendelsene du vil ha, eller klikk Velg alle. Kryss av for Sporing oppdatert hvis systemet ditt trenger hver sporingsskanning.

Opprett den

Klikk Opprett webhook. Du ser Webhooken er opprettet.

Vinduet Opprett webhook med Navn, Endpoint URL, Velg alle og avkrysningsboksene for sendingshendelser — Opprett webhook: Navn, Endpoint URL og hendelsene

Felt	Påkrevd	Hva du skriver inn
Navn *	Ja	Et navn du kjenner igjen, for eksempel «Ordrevarsler». Opptil 100 tegn.
Endpoint URL *	Ja	Den fullstendige adressen på serveren din, for eksempel `https://example.com/webhooks`.
Merkevare	Nei	Vises bare hvis organisasjonen din har merkevarer. Velg en merkevare, og Denne webhooken mottar bare hendelser fra denne merkevaren. Standardvalget, Ingen merkevare (hele organisasjonen), mottar hendelsene fra alle merkevarer.
Hendelser *	Ja, minst én	Hendelsene som skal sendes. Se listen nedenfor.

Opprett webhook er grået ut til du har fylt ut navnet, adressen og minst én hendelse. Hvis opprettingen feiler med Du har nådd grensen i planen din. Oppgrader planen eller fjern noe du ikke bruker lenger., slett en webhook du ikke bruker lenger, eller oppgrader planen din.

Hendelsene

Det finnes ni hendelser, i tre grupper. Det tekniske navnet i den andre kolonnen er det systemet ditt mottar.

Vinduet Opprett webhook med alle ni hendelser avkrysset, inkludert Sporing oppdatert — Velg alle krysser av for alle hendelser, inkludert Sporing oppdatert

Hendelse	Navnet systemet ditt mottar	Sendes når
Sending opprettet	`shipment.created`	En sending opprettes.
Sending oppdatert	`shipment.updated`	En sending endres.
Sending sendt	`shipment.dispatched`	En sending sendes og har fått fraktetiketten sin.
Sending kansellert	`shipment.cancelled`	En sending slettes.
Feil på sending	`shipment.error`	Sending av en sending til transportøren feiler.
Ordre opprettet	`order.created`	En ordre opprettes gjennom API-et.
Ordre oppdatert	`order.updated`	En ordre endres i Zippendo eller gjennom API-et.
Ordre kansellert	`order.cancelled`	En ordre slettes i Zippendo eller gjennom API-et.
Sporing oppdatert	`tracking.updated`	En pakke får en ny sporingshendelse.

Ordrer som kommer inn fra en tilkoblet nettbutikk, og endringene nettbutikken sender senere, sender ikke ordrehendelser. Systemet ditt får likevel høre om dem gjennom sendingshendelsene: Zippendo oppretter en sending for hver ordre det importerer. Send test sender en testmelding som heter webhook.test. Du kan ikke krysse av for den som en hendelse.

Rediger eller sett en webhook på pause

Klikk på raden, eller Rediger, for å åpne Rediger webhook. Den har de samme feltene som Opprett webhook, pluss Aktiv. Klikk Lagre endringer når du er ferdig.

Vinduet Rediger webhook med Navn, Endpoint URL, en avkrysningsboks Aktiv og hendelsene — Rediger webhook: de samme feltene, pluss Aktiv

Fjern avkrysningen for Aktiv for å slutte å sende uten å slette webhooken eller Leveringslogg. Kolonnen Status viser da Inaktiv. Kryss av igjen for å begynne å sende.

Leveringslogg

Leveringslogg på en rad viser de siste forsøkene på å levere til den adressen.

Kolonne	Hva den viser
Hendelse	Hendelsen som ble sendt, for eksempel `shipment.created` eller `webhook.test`.
Status	Statuskoden serveren din svarte med, grønn for suksess og rød for feil, eller Ikke tilgjengelig hvis det ikke kom noe svar.
Varighet	Hvor lang tid serveren din brukte på å svare.
Forsøk	Hvilket forsøk dette var.
Feil	Hva som gikk galt, hvis noe.
Tid	Når forsøket ble gjort.

Zippendo venter i opptil 10 sekunder på at serveren din skal svare. Hvis den ikke svarer, eller svarer med en feil, prøver Zippendo igjen, opptil 5 ganger til sammen, og venter litt lenger hver gang. Hvert forsøk er en rad i loggen.

Send en testmelding

Klikk Send test på en rad. Du ser Testhendelsen er sendt. Testmeldingen ser slik ut:

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

Åpne Leveringslogg for å se om serveren din mottok den.

Slett en webhook

Klikk Slett på en rad. Slett webhook ber deg skrive navnet på webhooken med store bokstaver og deretter klikke Slett. Webhooken og Leveringslogg fjernes, og du ser Webhooken er slettet.

Vinduet Slett webhook med et felt for å skrive navnet for å bekrefte — Slett webhook: skriv navnet med store bokstaver for å bekrefte

For utviklere: meldingsformat og signatur

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

Header	Verdi
`Content-Type`	`application/json`
`X-Webhook-Signature`	HMAC-SHA256 av selve innholdet, hex, med hemmeligheten til webhooken som nøkkel
`X-Webhook-Event`	Navnet på hendelsen
`X-Webhook-Id`	Én ID per levering. Hvert nytt forsøk på den samme leveringen sender den samme ID-en, så du kan bruke den til å hoppe over duplikater.

Zippendo oppretter hemmeligheten når du oppretter webhooken. Appen viser den ikke: les den med forespørselen Get webhook i API-referansen (listeforespørselen utelater den). Kontroller signaturen før du leser innholdet. Et gjennomarbeidet eksempel finnes i Kom i gang med webhooks. Ordrer som sendes inn i en egendefinert ordrekanal, signeres på samme måte, med en X-Zippendo-Signature-header: API for egendefinert kanal.

Svar raskt med en 2xx-status og gjør arbeidet etterpå. Bruk https://-adresser. Webhooks som ikke er Aktiv, mottar ingenting.

Relatert

Opprett et API-token: systemet ditt spør Zippendo, i stedet for at Zippendo forteller systemet ditt.
Sporings-webhooks fra transportører: transportører som sender sporing til Zippendo.
Koble til Slack, Klaviyo og andre apper: ingen egen server nødvendig.
Shopify-innstillinger / Koble til WooCommerce: webhookene for nettbutikken som Zippendo setter opp for deg.

Oversikt

Sendinger

Ordrer og kanaler

Transportører

Koble til en transportør

Koble til en integrasjon

Utskrift

Automatisering

Konto

Søk og dashboard

API og hendelser

Hvor du finner det

Listen Webhooks

Opprett en webhook

Hendelsene

Rediger eller sett en webhook på pause

Leveringslogg

Send en testmelding

Slett en webhook

For utviklere: meldingsformat og signatur

Relatert

​Hvor du finner det

​Listen Webhooks

​Opprett en webhook

​Hendelsene

​Rediger eller sett en webhook på pause

​Leveringslogg

​Send en testmelding

​Slett en webhook

​For utviklere: meldingsformat og signatur

​Relatert

Hvor du finner det

Listen Webhooks

Opprett en webhook

Hendelsene

Rediger eller sett en webhook på pause

Leveringslogg

Send en testmelding

Slett en webhook

For utviklere: meldingsformat og signatur

Relatert