> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Sende Ereignisse zu Sendungen, Bestellungen und Sendungsverfolgung von Zippendo an dein eigenes System - Name, Endpunkt-URL, Ereignisse, Zustellprotokoll, Testnachricht, Bearbeiten, Löschen und Signaturprüfung.

**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](/docs/de/how-to/tracking-webhooks). |
| Shopify-Webhooks für Bestellungen | Bei einem Shopify-Verkaufskanal | Shopify → Zippendo. Zippendo richtet sie ein. Siehe [Shopify-Einstellungen](/docs/de/how-to/shopify-settings). |
| WooCommerce-Webhooks für Bestellungen | Bei einem WooCommerce-Verkaufskanal | WooCommerce → Zippendo. Siehe [WooCommerce verbinden](/docs/de/how-to/connect-woocommerce). |
| Bestellungen eines eigenen Kanals | Bei einem eigenen Verkaufskanal | Dein System → Zippendo. Siehe [API für eigene Kanäle](/docs/de/how-to/custom-channel-api). |

Um Ereignisse an Slack, Klaviyo und ähnliche Apps zu senden, ohne etwas zu bauen, nutze stattdessen [Slack, Klaviyo und andere Apps verbinden](/docs/de/how-to/connect-an-integration).

Rundgang durch die Einstellungen: [Einstellungen, Team und Marken](/docs/de/tutorials/settings-team-brands). Was jede Nachricht enthält: [Webhooks-Schnellstart](/docs/de/quickstarts/webhooks). Nachrichten, die nicht ankommen: [Fehlgeschlagene Webhook-Zustellungen](/docs/de/knowledge-base/webhook-delivery-failures).

<Info>
  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.
</Info>

## 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.

<Frame caption="Die Liste Webhooks: Name, URL, Ereignisse, Status und Aktionen">
  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/01-webhooks-list-light.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=59d9647d197c9d01054763127fea2245" alt="Tab Webhooks in den Einstellungen mit einem Webhook in der Liste und Webhook hinzufügen in der Kopfzeile" className="block dark:hidden" width="2880" height="1800" data-path="images/de/how-to/webhooks/01-webhooks-list-light.png" />

  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/01-webhooks-list-dark.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=ce5d6d844f1db7bcaa23e12fddf5ef7b" alt="Tab Webhooks in den Einstellungen mit einem Webhook in der Liste und Webhook hinzufügen in der Kopfzeile" className="hidden dark:block" width="2880" height="1800" data-path="images/de/how-to/webhooks/01-webhooks-list-dark.png" />
</Frame>

## 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](/docs/de/how-to/search-and-filters).

Wenn es noch keine Webhooks gibt, zeigt die Liste **Keine Webhooks** und eine Schaltfläche **Ersten Webhook erstellen**.

## Einen Webhook erstellen

<Steps>
  <Step title="Fenster öffnen">
    Klicke auf **Webhook hinzufügen** oder auf **Ersten Webhook erstellen**, wenn die Liste leer ist. Das Fenster **Webhook erstellen** öffnet sich.
  </Step>

  <Step title="Name und Adresse">
    Fülle **Name \*** und **Endpunkt-URL \*** aus. Nutze eine Adresse, die mit `https://` beginnt.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Erstellen">
    Klicke auf **Webhook erstellen**. Du siehst **Webhook erstellt**.
  </Step>
</Steps>

<Frame caption="Webhook erstellen: Name, Endpunkt-URL und die Ereignisse">
  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/02-create-webhook-light.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=910cc767d72496e3481adc17a3bd1cee" alt="Fenster Webhook erstellen mit Name, Endpunkt-URL, Alle auswählen und den Kontrollkästchen für Ereignisse zu Sendungen" className="block dark:hidden" width="2880" height="2800" data-path="images/de/how-to/webhooks/02-create-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/02-create-webhook-dark.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=82e2d0f9dc898d65f5b9c60d480d82a0" alt="Fenster Webhook erstellen mit Name, Endpunkt-URL, Alle auswählen und den Kontrollkästchen für Ereignisse zu Sendungen" className="hidden dark:block" width="2880" height="2800" data-path="images/de/how-to/webhooks/02-create-webhook-dark.png" />
</Frame>

| 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.

<Frame caption="Alle auswählen hakt jedes Ereignis an, einschließlich Sendungsverfolgung aktualisiert">
  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/03-events-tracking-light.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=aa20ac27523061a1966d5546eeb911cf" alt="Fenster Webhook erstellen mit allen neun angehakten Ereignissen, einschließlich Sendungsverfolgung aktualisiert" className="block dark:hidden" width="2880" height="2800" data-path="images/de/how-to/webhooks/03-events-tracking-light.png" />

  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/03-events-tracking-dark.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=d5b5bb0711be3040025b4dd22cf8f155" alt="Fenster Webhook erstellen mit allen neun angehakten Ereignissen, einschließlich Sendungsverfolgung aktualisiert" className="hidden dark:block" width="2880" height="2800" data-path="images/de/how-to/webhooks/03-events-tracking-dark.png" />
</Frame>

| 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.

<Frame caption="Webhook bearbeiten: dieselben Felder, plus Aktiv">
  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/04-edit-webhook-light.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=23800b6d2d97788ab3ce9eb42916c230" alt="Fenster Webhook bearbeiten mit Name, Endpunkt-URL, einem Kontrollkästchen Aktiv und den Ereignissen" className="block dark:hidden" width="2880" height="1800" data-path="images/de/how-to/webhooks/04-edit-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/04-edit-webhook-dark.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=1611741e7a32e04c7b1dc871b138f0c5" alt="Fenster Webhook bearbeiten mit Name, Endpunkt-URL, einem Kontrollkästchen Aktiv und den Ereignissen" className="hidden dark:block" width="2880" height="1800" data-path="images/de/how-to/webhooks/04-edit-webhook-dark.png" />
</Frame>

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.

<Frame caption="Zustellprotokoll: Ereignis, Status, Dauer, Versuch, Fehler und Zeit">
  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/05-delivery-log-light.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=80ac8f6f18bde89d334e0e138afe70a1" alt="Zustellprotokoll mit Ereignisnamen, Antwortstatus, Dauer, Versuch und Zeit" className="block dark:hidden" width="2880" height="1800" data-path="images/de/how-to/webhooks/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/05-delivery-log-dark.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=9cf7a8c3624d3b573238e94ff04f2544" alt="Zustellprotokoll mit Ereignisnamen, Antwortstatus, Dauer, Versuch und Zeit" className="hidden dark:block" width="2880" height="1800" data-path="images/de/how-to/webhooks/05-delivery-log-dark.png" />
</Frame>

| 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:

```json theme={null}
{
  "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**.

<Frame caption="Webhook löschen: Gib den Namen in Großbuchstaben ein, um zu bestätigen">
  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/06-delete-webhook-light.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=61621e35fdf84d1094a9c9f95f7a2a2f" alt="Fenster Webhook löschen mit einem Feld, in das du den Namen zur Bestätigung eingibst" className="block dark:hidden" width="2880" height="1800" data-path="images/de/how-to/webhooks/06-delete-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/SHlBP07-TDfb75K3/images/de/how-to/webhooks/06-delete-webhook-dark.png?fit=max&auto=format&n=SHlBP07-TDfb75K3&q=85&s=7ce077d055180180a08cc6fef1ae4205" alt="Fenster Webhook löschen mit einem Feld, in das du den Namen zur Bestätigung eingibst" className="hidden dark:block" width="2880" height="1800" data-path="images/de/how-to/webhooks/06-delete-webhook-dark.png" />
</Frame>

## 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](/docs/api-reference/overview) aus (die Listenanfrage lässt es weg). Prüfe die Signatur, bevor du den Body liest. Ein durchgespieltes Beispiel steht im [Webhooks-Schnellstart](/docs/de/quickstarts/webhooks). 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](/docs/de/how-to/custom-channel-api).

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

## Verwandte Themen

* [API-Token erstellen](/docs/de/how-to/create-an-api-token): Dein System fragt Zippendo, statt dass Zippendo deinem System Bescheid gibt.
* [Webhooks zur Sendungsverfolgung der Versanddienstleister](/docs/de/how-to/tracking-webhooks): Versanddienstleister, die Sendungsverfolgung an Zippendo senden.
* [Slack, Klaviyo und andere Apps verbinden](/docs/de/how-to/connect-an-integration): kein eigener Server nötig.
* [Shopify-Einstellungen](/docs/de/how-to/shopify-settings) / [WooCommerce verbinden](/docs/de/how-to/connect-woocommerce): die Webhooks des Onlineshops, die Zippendo für dich einrichtet.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.