Met webhooks kun je automatisch een melding naar een externe applicatie sturen zodra er iets gebeurt in Oneteam. Zo kun je Oneteam koppelen aan je eigen systemen, dashboards of automatiseringen zonder handmatig gegevens over te zetten.
Een webhook stuurt een HTTP-verzoek naar een URL die jij instelt. Die URL ontvangt vervolgens informatie over de gebeurtenis, bijvoorbeeld wanneer er iets wordt aangemaakt, gewijzigd of afgerond.
Wanneer gebruik je webhooks?
Webhooks zijn handig als je Oneteam wilt verbinden met andere tools. Denk aan:
• een intern systeem bijwerken wanneer er een nieuwe medewerker of wijziging is
• notificaties sturen naar een eigen workflow- of integratieplatform
• gegevens synchroniseren met een datawarehouse of rapportagetool
• automatische opvolging starten na een specifieke actie in Oneteam
Een webhook instellen
1. Ga via het organisatiedashboard naar de instellingen van je organisatie.
2. Open het onderdeel Webhooks.
3. Klik op Webhook toevoegen.
4. Vul de URL in waar Oneteam de webhook naartoe moet sturen.
5. Kies voor welke gebeurtenissen je meldingen wilt ontvangen.
6. Sla de webhook op.
Vanaf dat moment stuurt Oneteam automatisch een verzoek naar de ingestelde URL wanneer een gekozen gebeurtenis plaatsvindt.
Webhook payload
Elke webhook bevat informatie over de gebeurtenis. De exacte inhoud kan per type gebeurtenis verschillen, maar meestal bevat de payload:
• het type gebeurtenis
• het tijdstip waarop de gebeurtenis plaatsvond
• de organisatie waarvoor de gebeurtenis geldt
• de relevante gegevens van het object dat is aangemaakt of gewijzigd
Voorbeeld:
{ "event": "example.created", "createdAt": "2026-07-31T14:26:00Z", "data": { "id": "abc123", "name": "Voorbeeld" } }Beveiliging
Gebruik altijd een HTTPS-URL voor je webhook endpoint. Als Oneteam een signing secret of verificatieheader aanbiedt, controleer die dan aan jouw kant voordat je de payload verwerkt. Zo weet je zeker dat het verzoek echt vanuit Oneteam komt.
Deel webhook URLs en secrets niet publiek en sla ze veilig op in je eigen systeem.
Webhook testen
Na het aanmaken van een webhook kun je deze testen door een gebeurtenis te triggeren waarvoor de webhook is ingesteld. Controleer daarna in je eigen systeem of het verzoek is ontvangen en correct verwerkt.
Laat het ons weten via de chat als we je ergens bij kunnen adviseren of helpen!