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.
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:
I Zapier skapar du en ny Zap och väljer Webhooks by Zapier som trigger.
Välj händelsen Catch Hook.
Zapier ger dig en URL som ser ut ungefär som https://hooks.zapier.com/hooks/catch/12345/abcde/. Kopiera den.
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.
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.
Tillbaka i Zapier klickar du på Testa trigger — du borde se att händelsen kommer igenom.
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
Öppna https://seasons.scoreholio.com och logga in med ditt Pro-konto
Gå till Inställningar → Webhooks
Klicka på Lägg till webhook
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)
Markera rutorna för de händelser du bryr dig om
(Valfritt) Välj specifika säsonger att bevaka — lämna det tomt för att få händelser för alla säsonger
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:
Ta den råa request-body:n
Beräkna samma fingeravtryck med ditt signeringshemliga värde
Jämför det med värdet i headern
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.)
Senast uppdaterad