> For the complete documentation index, see [llms.txt](https://stamply.gitbook.io/stamply-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stamply.gitbook.io/stamply-knowledge-base/api/webhooks.md).

# 🪝 Webhooks

Die Webhooks-Sektion ermöglicht es Ihnen, bestehende sowie neue Webhooks zu betrachten. Lassen Sie uns schauen, wie dies erfolgt.

> **Stamply > Linker Menü > Einstellungen**

### Wie man einen Webhook hinzufügt

1. Folgen Sie dem oben genannten Workflow, um auf das Einstellungsprogramm zu gelangen.
2. Klicken Sie oben auf den Reiter „Webhooks”. Dies führt Sie zum entsprechenden Bildschirm.

<figure><img src="/files/TOFfxluO8IdIepUr6bT8" alt=""><figcaption></figcaption></figure>

3. Um einen Webhook zu erstellen, klicken Sie auf die Schaltfläche „Webhook hinzufügen“. Dadurch wird das Pop-up-Fenster „Webhook hinzufügen“ geöffnet.

<figure><img src="/files/9aseVN0FL998aOM3ecUX" alt=""><figcaption></figcaption></figure>

4. Hier, geben Sie die URL im Feld ein, das oben im Popup angezeigt wird.

<figure><img src="/files/3Wo6fLKAxQiZBup2PGzn" alt=""><figcaption></figcaption></figure>

5. Markieren Sie das Kästchen für das Ereignis, für das Sie den Webhook auslösen möchten.

<figure><img src="/files/PnMlzywlcnWQwkSCUkcW" alt=""><figcaption></figcaption></figure>

6. Markieren Sie den Status als aktiv, indem Sie den Status-Schalter verwenden, während die Auswahl getroffen wird. Sobald Sie die erforderlichen Auswahlen getroffen haben, klicken Sie auf die Schaltfläche „Webhook hinzufügen”.

<figure><img src="/files/ivYaoDNV1X7hbMwjArNg" alt=""><figcaption></figcaption></figure>

7. Dadurch wird der Webhook hinzugefügt und in der Liste angezeigt. Wenn Sie auf den Namen des Webhooks klicken, können Sie ihn ändern.

<figure><img src="/files/ljs9uyhH2J7S4SmQJDra" alt=""><figcaption></figcaption></figure>

7. Stellen Sie sicher, dass Sie nach den Änderungen speichern.

### Beschreibung von Webhook-Events

### 🧍‍♂Karten & Kunden (Karteninhaber)

**CardBalanceUpdatedEvent=**\
Ausgelöst, wenn sich der Kartensaldo ändert (z. B. Boni oder Cashback werden gutgeschrieben oder abgebucht).

**CardExpiredEvent=**\
Ausgelöst, wenn die Karte eines Kunden ihr Ablaufdatum erreicht.

**CardInstalledEvent=**\
Ausgelöst, wenn eine Karte in das Wallet des Kunden hinzugefügt wird (Apple Wallet / Google Wallet / PWA).

**CardIssuedEvent=**\
Ausgelöst, wenn eine neue Karte an einen Kunden ausgegeben wird.

**CardRemovedEvent=**\
Ausgelöst, wenn eine Karte vom Kunden oder Administrator entfernt wird. Der Kartenstatus ändert sich von „installed“ zu „deleted“.

**CardScannedEvent=**\
Ausgelöst, wenn die Karte von einem Scanner gescannt wird.

**CustomerCreatedEvent=**\
Ausgelöst, wenn ein neuer Kunde erstellt wird (entweder durch Kartenausgabe oder manuelles Hinzufügen zur Datenbank).

**CustomerReferralCreatedEvent=**\
Ausgelöst, wenn eine Empfehlung hinzugefügt wird (z. B. bei Kartenausgabe über einen Empfehlungslink).

**CustomerSegmentLinkedEvent=**\
Ausgelöst, wenn ein Kunde basierend auf seiner Aktivität/Wert in ein neues RFM-Segment verschoben wird.

**FeedbackCreatedEvent=**\
Ausgelöst, wenn ein Kunde Feedback hinterlässt (entweder durch Auswahl einer Sternebewertung oder durch Schreiben eines Kommentars).