> 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/scoreholio-seasons/was-ist-scoreholio-seasons/webhooks.md).
# Webhooks
## Webhooks
Vor Webhooks war der einzige Weg, Daten aus Scoreholio Seasons herauszubekommen, sich 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 dir in dem Moment zu, in dem sich etwas ändert. Du gibst uns eine URL, sagst uns, für welche Events du dich interessierst, und wir rufen diese URL jedes Mal auf, wenn eines davon passiert.
Das heißt, du kannst:
* Mitglieder in dem Moment in dein CRM synchronisieren, in dem 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 aktuell der einzige Weg, programmgesteuert Daten aus Seasons herauszubekommen. 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 empfangen und daraus fast jede beliebige Aktion machen — eine Zeile zu einem Google Sheet hinzufügen, eine Mailchimp-Kampagne senden, in Slack posten, einen HubSpot-Kontakt erstellen, eine SMS senden und so weiter.
So richtest du das in Zapier ein:
1. Erstelle in Zapier einen neuen Zap und wähle Webhooks by Zapier als Trigger aus.
2. Wähle das Ereignis Catch Hook aus.
3. Zapier gibt dir eine URL, die ungefähr so aussieht: . Kopier sie.
4. Geh in Scoreholio zu Einstellungen → Webhooks → Webhook hinzufügen, füge diese URL ein und wähle die Events aus, die du möchtest.
5. Speichern. Mach jetzt in Scoreholio die Sache, die das Event auslösen soll (z. B. ein Testmitglied hinzufügen), damit Zapier sehen kann, wie die Payload aussieht.
6. Zurück in Zapier auf Test trigger klicken — du solltest sehen, wie das Event durchkommt.
7. Füg als Nächstes die gewünschte Aktion hinzu: Google Sheets, Slack, Mailchimp, Gmail usw.
Der kostenlose Plan von Zapier enthält Webhooks by Zapier, aber bei vielen Events musst du möglicherweise auf einen kostenpflichtigen Plan wechseln. Wenn du mit vielen Events rechnest, prüf die Aufgabenlimits von Zapier.
Dasselbe Muster funktioniert mit Make, n8n, Pipedream und anderen No-Code-Tools — sie haben alle einen Schritt wie „webhook trigger“ oder „catch webhook“.
### Worauf kannst du lauschen?
Immer wenn eines dieser Dinge in deinem Konto passiert, schicken wir eine Nachricht an deine URL:
* Saisons — 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 aus, welche davon dich interessieren — du musst nicht alle abonnieren.
### So richtest du einen ein
1. Öffne und logge dich mit deinem Pro-Account ein
2. Geh zu Einstellungen → Webhooks
3. Klick auf Webhook hinzufügen
4. Füg die URL ein, an die wir die Events senden sollen (z. B. oder deine Zapier-Catch-Hook-URL)
5. Aktiviere die Kästchen für die Events, die dich interessieren
6. (Optional) Wähl bestimmte Saisons aus, die du beobachten willst — lass es leer, um Events für alle Saisons zu bekommen
7. Klick auf Speichern
Wenn du es speicherst, zeigen wir dir ein Signaturgeheimnis — kopier es an einen sicheren Ort. Wir zeigen es dir nur einmal. Du brauchst es, um zu prüfen, ob Nachrichten wirklich von uns kommen (siehe unten).
### „Nur für diese Saisons“ vs. „alle Saisons“
Standardmäßig wird ein Webhook für jede Saison in deinem Konto ausgelöst. Wenn dich nur zum Beispiel deine Liga im Frühjahr 2026 interessiert, klick im Formular auf Saisons bearbeiten und wähl die aus, die du möchtest.
Hinweis: season.created, season.updated und season.deleted werden immer für jede Saison ausgelöst, unabhängig von diesem Filter — weil der Filter in dem Moment, in dem eine Saison erstellt oder gelöscht wird, noch nicht wirklich greift.
### 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 Signaturgeheimnis plus dem Nachrichtentext gebildet wird.
Wenn du einen Webhook erhältst:
1. Nimm den rohen Request-Body
2. Berechne denselben Fingerabdruck mit deinem Signaturgeheimnis
3. Vergleiche ihn mit dem Wert im Header
4. Wenn sie übereinstimmen → sind wir es. Wenn nicht → wirf es weg.
So können irgendwelche Leute im Internet nicht gefälschte Events per POST an deine URL schicken.
Wenn du Zapier (oder ein anderes No-Code-Tool) verwendest, kannst du die Signaturprüfung überspringen — die Webhook-URLs von Zapier sind bereits ein langer zufälliger String, der sich fast unmöglich erraten lässt. Die Signaturprüfung ist hauptsächlich für den Fall gedacht, dass du deinen eigenen Server betreibst.
### Einen Webhook pausieren
Wenn dein Server wegen Wartungsarbeiten nicht verfügbar ist, musst du den Webhook nicht löschen — bearbeite ihn einfach und setz Aktiv auf Pausiert. Wir hören mit dem Senden auf, bis du ihn wieder aktivierst.
### Woher weiß ich, dass es funktioniert?
Die Webhook-Liste zeigt dir bei jedem Eintrag:
* Letztes — war die letzte Zustellung ein ✓ oder ein ✗
* Wann — wie lange es her ist, dass wir zuletzt versucht haben zu senden
Wenn du 계속 ✗ siehst, antwortet deine URL wahrscheinlich nicht mit einem 2xx-Statuscode oder sie ist nicht erreichbar.
### Löschen
Klick in der Zeile auf Optionen → Löschen. Dann empfängt er sofort keine Events mehr. (Das Signaturgeheimnis ist auch für immer weg, also bekommst du ein neues Geheimnis, wenn du ihn jemals neu erstellst.)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.scoreholio.com/de/scoreholio-seasons/was-ist-scoreholio-seasons/webhooks.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.