FITsociety Helpcentrum

Webhooks instellen: wijzigingen automatisch doorgeven

Bijgewerkt op 8 november 2026 · 3 min leestijd

Technische documentatie: alle actuele API-routes, rechten en voorbeelden staan op docs.fitsociety.io. Begin als ontwikkelaar bij de Public API-snelstart.

Een webhook stuurt een melding naar een ander systeem als er iets gebeurt in FITsociety. Zo kan je CRM reageren op een nieuw lid, of je automatisering starten na een nieuwe boeking.

In dit artikel

Wat heb je nodig?

Je hebt toegang nodig tot Public API en webhookbeheer voor je bedrijf, plus een ontvangstadres van je ontwikkelaar of automatiseringstool. Dit moet een publiek bereikbaar HTTPS-adres zijn. Een localhost-adres of intern netwerkadres werkt niet.

Een webhook meldt een gebeurtenis; het andere systeem voert de vervolgstap uit. Voor aanvullende gegevens of een wijziging in FITsociety kan daarnaast een API-client met passende rechten nodig zijn.

Maak de webhook aan

  1. Ga in het juiste bedrijf naar Instellingen → Plug-ins en integraties → Webhooks.

  2. Kies Webhook toevoegen en geef een herkenbare naam.

  3. Vul bij Target URL het ontvangstadres in.

  4. Controleer Events en selecteer alleen de gewenste gebeurtenissen, zoals client.created of booking.created. Controleer ook de voorselectie.

  5. Sla de webhook op en kopieer het eenmalig getoonde signing secret. Laat je ontwikkelaar dit veilig opslaan en de handtekening van meldingen controleren.

Test en controleer de afleveringen

Gebruik de testactie bij de webhook en controleer of het ontvangende systeem de melding verwerkt. Bekijk ook de recente afleverpogingen in FITsociety. Een succesvolle aflevering heeft status delivered: de ontvanger antwoordde met HTTP 2xx.

Bij een fout volgen maximaal drie afleverpogingen in totaal. failed kan nog een nieuwe poging krijgen; exhausted betekent dat de pogingen op zijn. Laat bij fouten het ontvangstadres, de bereikbaarheid en de foutmelding controleren.

Een geslaagde test bewijst dat de ontvangst werkt. Controleer daarnaast één echte gebeurtenis en de gewenste vervolgactie voordat je op de workflow vertrouwt.

Wijzigen en zorgvuldig verwerken

Via bewerken pas je het adres, de gebeurtenissen of de status aan. Zet de webhook op Uitgeschakeld om nieuwe meldingen via deze webhook te stoppen. Controleer eventuele al ontvangen of lopende acties ook in het andere systeem.

Meldingen bevatten compacte gegevens, geen volledig cliëntdossier. Laat de ontvanger dubbele meldingen herkennen aan het stabiele event-ID, zodat dezelfde gebeurtenis niet tweemaal een actie start.

Voor beheer via de API zijn webhooks:read, webhooks:write en voor afleverpogingen webhook_deliveries:read beschikbaar. De technische documentatie beschrijft events, payloads en handtekeningcontrole.

Verder lezen

Technische documentatie voor je ontwikkelaar (Engels)

Was dit artikel nuttig? Bedankt voor je feedback!

Bedankt, we lezen elke toelichting mee.

Gerelateerde artikelen