Webhooks

Webhooks informieren dein eigenes System in dem Moment, in dem in Zippendo etwas passiert: Eine Sendung wird erstellt oder versendet, eine Bestellung ändert sich oder ein Paket erhält ein neues Ereignis zur Sendungsverfolgung. Zippendo sendet eine Nachricht an eine Adresse (URL) auf deinem Server. Du richtest sie unter Webhooks in den Einstellungen ein; die empfangende Seite baut meist ein Entwickler. Das sind nicht die anderen Arten von Webhooks, denen du in Zippendo begegnen kannst:

Art	Wo	Richtung
Webhooks (diese Seite)	Einstellungen → Webhooks	Zippendo → dein Server
Webhooks zur Sendungsverfolgung der Versanddienstleister	Bei einem Versanddienstleister	Versanddienstleister → Zippendo. Siehe Webhooks zur Sendungsverfolgung der Versanddienstleister.
Shopify-Webhooks für Bestellungen	Bei einem Shopify-Verkaufskanal	Shopify → Zippendo. Zippendo richtet sie ein. Siehe Shopify-Einstellungen.
WooCommerce-Webhooks für Bestellungen	Bei einem WooCommerce-Verkaufskanal	WooCommerce → Zippendo. Siehe WooCommerce verbinden.
Bestellungen eines eigenen Kanals	Bei einem eigenen Verkaufskanal	Dein System → Zippendo. Siehe API für eigene Kanäle.

Um Ereignisse an Slack, Klaviyo und ähnliche Apps zu senden, ohne etwas zu bauen, nutze stattdessen Slack, Klaviyo und andere Apps verbinden. Rundgang durch die Einstellungen: Einstellungen, Team und Marken. Was jede Nachricht enthält: Webhooks-Schnellstart. Nachrichten, die nicht ankommen: Fehlgeschlagene Webhook-Zustellungen.

Webhooks sind in jedem Tarif enthalten: Free bis zu 5 Webhooks, Standard bis zu 10, Growth bis zu 25, Pro bis zu 100, Enterprise unbegrenzt viele.

Wo du es findest

Öffne das Organisationsmenü unten in der Seitenleiste, klicke auf Verwalten und dann auf den Tab Webhooks. Die Schaltfläche zum Erstellen ist Webhook hinzufügen oben rechts.

Tab Webhooks in den Einstellungen mit einem Webhook in der Liste und Webhook hinzufügen in der Kopfzeile — Die Liste Webhooks: Name, URL, Ereignisse, Status und Aktionen

Die Liste Webhooks

Spalte	Was sie zeigt
Name	Der Name, den du eingegeben hast.
Marke	Die Marke des Webhooks oder leer, wenn er die ganze Organisation abdeckt. Wird nur angezeigt, wenn deine Organisation Marken hat.
URL	Die Adresse, an die Zippendo sendet.
Ereignisse	Die ersten zwei Ereignisse, die er sendet, z. B. Sendung erstellt; die übrigen sind eingeklappt.
Status	Aktiv oder Inaktiv.
Erstellt	Wann er erstellt wurde.

Jede Zeile hat Zustellprotokoll, Test senden, Bearbeiten und Löschen. Ein Klick auf die Zeile öffnet Webhook bearbeiten. Um einen Webhook zu finden, klicke über der Liste auf Filter. Du kannst nach dem Namen suchen, Aktiv wählen (Ja oder Nein) und, wenn du Marken hast, eine Marke. Klicke auf Filter hinzufügen, um sie anzuwenden. Mehr zu Listen: Suche und Filter. Wenn es noch keine Webhooks gibt, zeigt die Liste Keine Webhooks und eine Schaltfläche Ersten Webhook erstellen.

Einen Webhook erstellen

Fenster öffnen

Klicke auf Webhook hinzufügen oder auf Ersten Webhook erstellen, wenn die Liste leer ist. Das Fenster Webhook erstellen öffnet sich.

Name und Adresse

Fülle Name * und Endpunkt-URL * aus. Nutze eine Adresse, die mit https:// beginnt.

Ereignisse auswählen

Hake die gewünschten Ereignisse an oder klicke auf Alle auswählen. Hake Sendungsverfolgung aktualisiert an, wenn dein System jeden Scan der Sendungsverfolgung braucht.

Erstellen

Klicke auf Webhook erstellen. Du siehst Webhook erstellt.

Feld	Erforderlich	Was du eingibst
Name *	Ja	Ein Name, den du wiedererkennst, z. B. „Bestellbenachrichtigungen“. Bis zu 100 Zeichen.
Endpunkt-URL *	Ja	Die vollständige Adresse auf deinem Server, z. B. `https://example.com/webhooks`.
Marke	Nein	Wird nur angezeigt, wenn deine Organisation Marken hat. Wähle eine Marke, und Dieser Webhook empfängt nur Ereignisse dieser Marke. Der Standard, Keine Marke (ganze Organisation), empfängt die Ereignisse jeder Marke.
Ereignisse *	Ja, mindestens eines	Die Ereignisse, die gesendet werden. Siehe die Liste unten.

Webhook erstellen bleibt ausgegraut, bis du den Namen, die Adresse und mindestens ein Ereignis ausgefüllt hast. Wenn das Erstellen mit Du hast das Limit deines Tarifs erreicht. Upgrade deinen Tarif oder entferne etwas, das du nicht mehr brauchst. fehlschlägt, lösche einen Webhook, den du nicht mehr nutzt, oder upgrade deinen Tarif.

Die Ereignisse

Es gibt neun Ereignisse in drei Gruppen. Der technische Name in der zweiten Spalte ist das, was dein System empfängt.

Fenster Webhook erstellen mit allen neun angehakten Ereignissen, einschließlich Sendungsverfolgung aktualisiert — Alle auswählen hakt jedes Ereignis an, einschließlich Sendungsverfolgung aktualisiert

Ereignis	Name, den dein System empfängt	Wird gesendet, wenn
Sendung erstellt	`shipment.created`	Eine Sendung erstellt wird.
Sendung aktualisiert	`shipment.updated`	Eine Sendung geändert wird.
Sendung versendet	`shipment.dispatched`	Eine Sendung versendet wird und ihr Versandetikett hat.
Sendung storniert	`shipment.cancelled`	Eine Sendung gelöscht wird.
Sendungsfehler	`shipment.error`	Das Versenden einer Sendung an den Versanddienstleister fehlschlägt.
Bestellung erstellt	`order.created`	Eine Bestellung über die API erstellt wird.
Bestellung aktualisiert	`order.updated`	Eine Bestellung in Zippendo oder über die API geändert wird.
Bestellung storniert	`order.cancelled`	Eine Bestellung in Zippendo oder über die API gelöscht wird.
Sendungsverfolgung aktualisiert	`tracking.updated`	Ein Paket ein neues Ereignis zur Sendungsverfolgung erhält.

Bestellungen, die aus einem verbundenen Onlineshop eingehen, und die Änderungen, die der Onlineshop später sendet, senden keine Bestellereignisse. Dein System erfährt trotzdem davon über die Ereignisse zu Sendungen: Zippendo erstellt für jede importierte Bestellung eine Sendung. Test senden sendet eine Testnachricht namens webhook.test. Du kannst sie nicht als Ereignis anhaken.

Einen Webhook bearbeiten oder pausieren

Klicke auf die Zeile oder auf Bearbeiten, um Webhook bearbeiten zu öffnen. Es hat dieselben Felder wie Webhook erstellen, plus Aktiv. Klicke auf Änderungen speichern, wenn du fertig bist.

Fenster Webhook bearbeiten mit Name, Endpunkt-URL, einem Kontrollkästchen Aktiv und den Ereignissen — Webhook bearbeiten: dieselben Felder, plus Aktiv

Entferne das Häkchen bei Aktiv, um das Senden zu stoppen, ohne den Webhook oder sein Zustellprotokoll zu löschen. Die Spalte Status zeigt dann Inaktiv. Hake es wieder an, um das Senden zu starten.

Zustellprotokoll

Zustellprotokoll in einer Zeile zeigt die letzten Zustellversuche an diese Adresse.

Spalte	Was sie zeigt
Ereignis	Das Ereignis, das gesendet wurde, z. B. `shipment.created` oder `webhook.test`.
Status	Der Statuscode, mit dem dein Server geantwortet hat, grün bei Erfolg und rot bei Fehlschlag, oder k. A., wenn es keine Antwort gab.
Dauer	Wie lange dein Server für die Antwort gebraucht hat.
Versuch	Der wievielte Versuch es war.
Fehler	Was schiefgelaufen ist, falls etwas schiefgelaufen ist.
Zeit	Wann der Versuch stattfand.

Zippendo wartet bis zu 10 Sekunden auf die Antwort deines Servers. Wenn er nicht antwortet oder mit einem Fehler antwortet, versucht Zippendo es erneut, insgesamt bis zu 5 Mal, und wartet dabei jedes Mal etwas länger. Jeder Versuch ist eine Zeile im Protokoll.

Eine Testnachricht senden

Klicke in einer Zeile auf Test senden. Du siehst Testereignis gesendet. Die Testnachricht sieht so aus:

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

Öffne das Zustellprotokoll, um zu sehen, ob dein Server sie empfangen hat.

Einen Webhook löschen

Klicke in einer Zeile auf Löschen. Webhook löschen bittet dich, den Namen des Webhooks in Großbuchstaben einzugeben und dann auf Löschen zu klicken. Der Webhook und sein Zustellprotokoll werden entfernt, und du siehst Webhook gelöscht.

Fenster Webhook löschen mit einem Feld, in das du den Namen zur Bestätigung eingibst — Webhook löschen: Gib den Namen in Großbuchstaben ein, um zu bestätigen

Für Entwickler: Nachrichtenformat und Signatur

Jede Nachricht ist ein POST mit einem JSON-Body { "event", "timestamp", "brandId", "data" } und diesen Headern:

Header	Wert
`Content-Type`	`application/json`
`X-Webhook-Signature`	HMAC-SHA256 des rohen Bodys, hexadezimal, mit dem Secret des Webhooks als Schlüssel
`X-Webhook-Event`	Der Name des Ereignisses
`X-Webhook-Id`	Eine ID pro Zustellung. Jeder erneute Versuch derselben Zustellung sendet dieselbe ID, sodass du damit Duplikate überspringen kannst.

Zippendo erstellt das Secret, wenn du den Webhook erstellst. Die App zeigt es nicht an: Lies es mit der Anfrage Get webhook in der API-Referenz aus (die Listenanfrage lässt es weg). Prüfe die Signatur, bevor du den Body liest. Ein durchgespieltes Beispiel steht im Webhooks-Schnellstart. Bestellungen, die in einen eigenen Verkaufskanal gepusht werden, werden auf dieselbe Weise signiert, mit einem Header X-Zippendo-Signature: API für eigene Kanäle.

Antworte schnell mit einem 2xx-Status und erledige die Arbeit danach. Nutze Adressen mit https://. Webhooks, die nicht Aktiv sind, empfangen nichts.

Überblick

Sendungen

Bestellungen & Verkaufskanäle

Versanddienstleister

Versanddienstleister verbinden

Integration verbinden

Drucken

Automatisierung

Konto

Suche & Dashboard

API & Ereignisse

Wo du es findest

Die Liste Webhooks

Einen Webhook erstellen

Die Ereignisse

Einen Webhook bearbeiten oder pausieren

Zustellprotokoll

Eine Testnachricht senden

Einen Webhook löschen

Für Entwickler: Nachrichtenformat und Signatur

Verwandte Themen

​Wo du es findest

​Die Liste Webhooks

​Einen Webhook erstellen

​Die Ereignisse

​Einen Webhook bearbeiten oder pausieren

​Zustellprotokoll

​Eine Testnachricht senden

​Einen Webhook löschen

​Für Entwickler: Nachrichtenformat und Signatur

​Verwandte Themen

Wo du es findest

Die Liste Webhooks

Einen Webhook erstellen

Die Ereignisse

Einen Webhook bearbeiten oder pausieren

Zustellprotokoll

Eine Testnachricht senden

Einen Webhook löschen

Für Entwickler: Nachrichtenformat und Signatur

Verwandte Themen