> 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/sv/scoreholio-seasons/vad-ar-scoreholio-seasons/webhooks.md).

# Webhooks

## Webhooks

Innan webhooks var det enda sättet att få ut data från Scoreholio Seasons att logga in och köra en rapport eller en export — en manuell ögonblicksbild i efterhand.

Webhooks vänder på det. I stället för att du kommer och hämtar datan skickar Scoreholio den till dig i samma ögonblick som något ändras. Du ger oss en URL, berättar vilka händelser du bryr dig om, och vi knackar på den URL:en varje gång en av dem händer.

<br>

Det betyder att du kan:

* Synka medlemmar till ditt CRM i samma ögonblick som de registrerar sig — ingen nattlig export.
* Skicka till Slack/Discord/Teams när en ny turnering skapas.
* Utlösa ett mejl när en säsongstransaktion registreras.
* Hålla en extern dashboard eller kalkylark uppdaterad i realtid.

Webhooks är just nu det enda sättet att programmatiskt få ut data från Seasons. Det finns inget publikt REST API.

### Har du ingen utvecklare? Använd Zapier.

Du behöver inte skriva någon kod för att använda webhooks. Zapier (och liknande verktyg som Make, n8n eller Pipedream) kan fånga en Scoreholio-webhook och göra om den till nästan vilken åtgärd du kan tänka dig — lägga till en rad i Google Sheets, skicka en Mailchimp-kampanj, posta i Slack, skapa en HubSpot-kontakt, skicka ett SMS och så vidare.

Så här kopplar du ihop det i Zapier:

1. I Zapier skapar du en ny Zap och väljer Webhooks by Zapier som trigger.
2. Välj händelsen Catch Hook.
3. Zapier ger dig en URL som ser ut ungefär som <https://hooks.zapier.com/hooks/catch/12345/abcde/>. Kopiera den.
4. I Scoreholio går du till Inställningar → Webhooks → Lägg till webhook, klistrar in den URL:en och väljer de händelser du vill ha.
5. Spara. Gör nu den grejen i Scoreholio som ska utlösa händelsen (t.ex. lägg till en testmedlem) så att Zapier kan se hur payloaden ser ut.
6. Tillbaka i Zapier klickar du på Testa trigger — du borde se att händelsen kommer igenom.
7. Lägg till vilken åtgärd du vill härnäst: Google Sheets, Slack, Mailchimp, Gmail, osv.

Zapier:s gratisplan inkluderar Webhooks by Zapier, men höga volymer av händelser kan göra att du behöver en betald plan. Om du förväntar dig många händelser, kolla Zapier:s gränser för tasks.

Samma mönster funkar för Make, n8n, Pipedream och andra no-code-verktyg — de har alla ett steg för "webhook-trigger" eller "fånga webhook".

### Vad kan du lyssna på?

När något av det här händer i ditt konto skickar vi ett meddelande till din URL:

* Säsonger — skapad, uppdaterad, raderad
* Turneringar — skapad, uppdaterad, raderad
* Medlemmar — skapad, uppdaterad, raderad
* Säsongstransaktioner — skapad, uppdaterad, raderad
* Arrangörer — skapad, uppdaterad, raderad
* Lag — skapad, uppdaterad, raderad (endast om lagrankningar är aktiverade för den säsongen)

Du väljer exakt vilka du bryr dig om — du behöver inte prenumerera på alla.

### Så här sätter du upp en

1. Öppna <https://seasons.scoreholio.com> och logga in med ditt Pro-konto
2. Gå till Inställningar → Webhooks
3. Klicka på Lägg till webhook
4. Klistra in URL:en dit du vill att vi ska skicka händelserna (t.ex. <https://your-server.com/scoreholio-events>, eller din Zapier Catch Hook-URL)
5. Markera rutorna för de händelser du bryr dig om
6. (Valfritt) Välj specifika säsonger att bevaka — lämna det tomt för att få händelser för alla säsonger
7. Klicka på Spara

När du sparar visar vi ett signeringshemligt värde — kopiera det till ett säkert ställe. Vi visar det bara en gång. Du behöver det för att verifiera att meddelandena verkligen kommer från oss (se nedan).

### "Bara för de här säsongerna" vs "alla säsonger"

Som standard triggas en webhook för varje säsong i ditt konto. Om du bara bryr dig om till exempel din liga för våren 2026, klicka på Redigera säsonger i formuläret och välj de du vill ha.

Obs: season.created, season.updated och season.deleted triggas alltid för varje säsong oavsett det här filtret — eftersom vid det ögonblick en säsong skapas eller raderas gäller filtret egentligen inte ännu.

### Hur vet jag att det verkligen är Scoreholio?

Varje begäran vi skickar innehåller ett headerfält som heter X-Scoreholio-Signature. Det är ett fingeravtryck som skapas av ditt signeringshemliga värde plus meddelandets body.

När du tar emot en webhook:

1. Ta den råa request-body:n
2. Beräkna samma fingeravtryck med ditt signeringshemliga värde
3. Jämför det med värdet i headern
4. Om de matchar → då är det vi. Om de inte gör det → kasta bort det.

Det här hindrar slumpmässiga personer på internet från att skicka falska händelser till din URL via POST.

Om du använder Zapier (eller ett annat no-code-verktyg) kan du hoppa över signaturkontrollen — Zapier:s webhook-URL:er är redan en lång slumpmässig sträng som nästan är omöjlig att gissa. Signaturverifiering är främst för när du kör din egen server.

### Pausa en webhook

Om din server är nere för underhåll behöver du inte radera webhooken — redigera den bara och ändra Aktiv till Pausad. Vi slutar skicka tills du ändrar tillbaka.

### Hur vet jag att det funkar?

Webhook-listan visar dig, för varje en:

* Senast — var den senaste leveransen en ✓ eller en ✗
* När — hur länge sedan vi senast försökte skicka

Om du fortsätter se ✗ svarar din URL troligen inte med en 2xx-statuskod, eller så är den nere.

### Radera

Klicka på Alternativ → Radera på raden. Då slutar den ta emot händelser direkt. (Det signeringshemliga värdet försvinner också för alltid, så om du någonsin skapar om den får du ett nytt hemligt värde.)

<br>