> For the complete documentation index, see [llms.txt](https://docs.scoreholio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scoreholio.com/de/punkte-uber-events-hinweg-verfolgen/track-points-across-events/webhooks.md).
# Seasons-Webhooks
## Webhooks
Vor Webhooks gab es nur eine Möglichkeit, Daten aus Scoreholio Seasons herauszubekommen: dich einzuloggen und einen Bericht oder Export auszuführen — ein manueller Schnappschuss im Nachhinein.
Webhooks drehen das um. Statt dass du die Daten abholst, schiebt Scoreholio sie zu dir, sobald sich etwas ändert. Du gibst uns eine URL, sagst uns, welche Ereignisse dich interessieren, und wir schicken einen Aufruf an diese URL, jedes Mal wenn eines davon passiert.
Das heißt, du kannst:
* Mitglieder in dein CRM synchronisieren, sobald sie sich anmelden — kein nächtlicher Export.
* In Slack/Discord/Teams posten, wenn ein neues Turnier erstellt wird.
* Eine E-Mail auslösen, wenn eine Saison-Transaktion erfasst wird.
* Ein externes Dashboard oder eine Tabelle in Echtzeit aktuell halten.
Webhooks sind derzeit der einzige Weg, programmgesteuert Daten aus Seasons herauszuholen. Es gibt keine öffentliche REST-API.
### Du hast keinen Entwickler? Nutz Zapier.
Du musst keinen Code schreiben, um Webhooks zu nutzen. Zapier (und ähnliche Tools wie Make, n8n oder Pipedream) kann einen Scoreholio-Webhook abfangen und daraus fast jede Aktion machen, die du dir vorstellen kannst — eine Zeile in ein Google Sheet einfügen, eine Mailchimp-Kampagne senden, in Slack posten, einen HubSpot-Kontakt erstellen, eine SMS senden und so weiter.
So richtest du es in Zapier ein:
1. Erstelle in Zapier einen neuen Zap und wähle Webhooks by Zapier als Trigger.
2. Wähle das Ereignis Catch Hook.
3. Zapier gibt dir eine URL, die ungefähr so aussieht: . Kopiere sie.
4. Gehe in Scoreholio zu Einstellungen → Webhooks → Webhook hinzufügen, füge diese URL ein und wähle die Ereignisse aus, die du möchtest.
5. Speichere. Mach jetzt in Scoreholio die Aktion, die das Ereignis auslösen soll (z. B. ein Test-Mitglied hinzufügen), damit Zapier sehen kann, wie der Payload aussieht.
6. Klicke zurück in Zapier auf Trigger testen — du solltest sehen, dass das Ereignis durchkommt.
7. Füge als Nächstes einfach die gewünschte Aktion hinzu: Google Sheets, Slack, Mailchimp, Gmail usw.
Der Gratisplan von Zapier enthält Webhooks by Zapier, aber viele Ereignisse können dich auf einen kostenpflichtigen Plan bringen. Wenn du mit vielen Ereignissen rechnest, prüfe Zapiers Task-Limits.
Dasselbe Muster funktioniert auch mit Make, n8n, Pipedream und anderen No-Code-Tools — sie haben alle einen Schritt wie „Webhook-Trigger“ oder „Webhook abfangen“.
### Worauf kannst du lauschen?
Immer wenn eines dieser Dinge in deinem Konto passiert, schicken wir eine Nachricht an deine URL:
* Seasons — erstellt, aktualisiert, gelöscht
* Turniere — erstellt, aktualisiert, gelöscht
* Mitglieder — erstellt, aktualisiert, gelöscht
* Saison-Transaktionen — erstellt, aktualisiert, gelöscht
* Organisatoren — erstellt, aktualisiert, gelöscht
* Teams — erstellt, aktualisiert, gelöscht (nur wenn Team-Rankings für diese Saison aktiviert sind)
Du wählst genau die aus, die dich interessieren — du musst nicht alle abonnieren.
### So richtest du eines ein
1. Öffne und logge dich mit deinem Pro-Konto ein
2. Gehe zu Einstellungen → Webhooks
3. Klicke auf Webhook hinzufügen
4. Füge die URL ein, an die wir die Ereignisse senden sollen (z. B. oder deine Zapier-Catch-Hook-URL)
5. Aktiviere die Kästchen für die Ereignisse, die dich interessieren
6. (Optional) Wähle bestimmte Seasons aus, die überwacht werden sollen — lass es leer, um Ereignisse für alle Seasons zu erhalten
7. Klicke auf Speichern
Wenn du speicherst, zeigen wir dir ein Signing Secret — kopiere es an einen sicheren Ort. Wir zeigen es nur einmal an. Du brauchst es, um zu prüfen, dass die Nachrichten wirklich von uns kommen (siehe unten).
### „Nur für diese Seasons“ vs. „alle Seasons“
Standardmäßig wird ein Webhook für jede Season in deinem Konto ausgelöst. Wenn dich nur z. B. deine Liga im Frühjahr 2026 interessiert, klicke im Formular auf Seasons bearbeiten und wähle die gewünschten aus.
Hinweis: season.created, season.updated und season.deleted werden immer für jede Season ausgelöst, unabhängig von diesem Filter — denn in dem Moment, in dem eine Season erstellt oder gelöscht wird, gilt der Filter noch nicht wirklich.
### Woher weiß ich, dass es wirklich Scoreholio ist?
Jede Anfrage, die wir senden, enthält einen Header namens X-Scoreholio-Signature. Das ist ein Fingerabdruck, der aus deinem Signing Secret plus dem Body der Nachricht erstellt wird.
Wenn du einen Webhook erhältst:
1. Nimm den rohen Request-Body
2. Berechne denselben Fingerabdruck mit deinem Signing Secret
3. Vergleiche ihn mit dem Wert im Header
4. Wenn sie übereinstimmen → sind wir es. Wenn nicht → wirf ihn weg.
Das verhindert, dass irgendwelche Leute im Internet gefälschte Ereignisse per POST an deine URL schicken.
Wenn du Zapier (oder ein anderes No-Code-Tool) verwendest, kannst du die Signaturprüfung überspringen — Zapier-Webhook-URLs sind bereits eine lange zufällige Zeichenfolge, die praktisch nicht zu erraten ist. Die Signaturprüfung ist hauptsächlich dann wichtig, wenn du deinen eigenen Server betreibst.
### Einen Webhook pausieren
Wenn dein Server wegen Wartungsarbeiten offline ist, musst du den Webhook nicht löschen — bearbeite ihn einfach und stelle Aktiv auf Pausiert um. Wir hören auf zu senden, bis du ihn wieder zurückstellst.
### Woher weiß ich, dass es funktioniert?
Die Webhook-Liste zeigt dir bei jedem Eintrag:
* Zuletzt — war die letzte Zustellung ein ✓ oder ein ✗
* Wann — wie lange es her ist, dass wir zuletzt versucht haben zu senden
Wenn du immer wieder ✗ siehst, antwortet deine URL wahrscheinlich nicht mit einem 2xx-Statuscode oder ist nicht erreichbar.
### Löschen
Klicke in der Zeile auf Optionen → Löschen. Dann werden sofort keine Ereignisse mehr empfangen. (Das Signing Secret ist dann auch für immer weg, also bekommst du bei einer erneuten Erstellung ein neues Secret.)