Webhooks

Webhooks sturen een klein bericht naar een URL die jij beheert wanneer er iets gebeurt in PeekHire — zodat je in realtime kunt reageren in plaats van de API te pollen.

Hoe webhooks werken

1. Je maakt een endpoint aan (een URL op je server of in een automatiseringstool) onder Ontwikkelaarstools → Webhooks.
2. Je kiest welke gebeurtenissen het moet ontvangen.
3. Wanneer er een gebeurtenis plaatsvindt, stuurt PeekHire een HTTP POST met een JSON-payload naar je endpoint.

Payloads zijn bewust klein — ze geven aan wat er is gebeurd en op welk object het betrekking heeft, zodat je de volledige details kunt ophalen via de REST API als je die nodig hebt.

Beschikbare gebeurtenissen

Gebeurtenissen omvatten de recruitmentcyclus, waaronder:

• Sollicitaties — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Sollicitatieopmerkingen — application.comment.created, application.comment.updated, application.comment.deleted.
• Campagnes — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Leveringen verifiëren

Elke levering is ondertekend, zodat je kunt bevestigen dat deze echt van PeekHire komt. Verifieer de handtekening op je endpoint voordat je de payload vertrouwt, en reageer met een 2xx-status om de ontvangst te bevestigen.

Leveringen bekijken

De weergave Leveringen toont recente webhookpogingen en hun resultaten, zodat je kunt bevestigen dat gebeurtenissen aankomen en een endpoint kunt debuggen dat niet reageert.

Tips

• Reageer snel met een 2xx en voer zwaar werk asynchroon uit.
• Maak je handler idempotent — dezelfde gebeurtenis kan soms meer dan één keer worden geleverd.
• Begin met een tool zoals Make, Zapier of n8n als je liever geen server beheert.