Webhooks

Webhooks sender en lille besked til en URL, du kontrollerer, hver gang der sker noget i PeekHire — så du kan reagere i realtid i stedet for at forespørge API'en igen og igen.

Sådan fungerer webhooks

1. Du opretter et slutpunkt (en URL på din server eller et automatiseringsværktøj) under Udviklerværktøjer → Webhooks.
2. Du vælger, hvilke hændelser det skal modtage.
3. Når en hændelse opstår, sender PeekHire en HTTP POST med et JSON-payload til dit slutpunkt.

Payloads er med vilje små — de identificerer, hvad der er sket, og hvilket objekt det handler om, så du kan hente alle detaljer fra REST API, hvis du har brug for dem.

Tilgængelige hændelser

Hændelser dækker rekrutteringsforløbet, herunder:

• Ansøgninger — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Ansøgningskommentarer — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampagner — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Verificering af leveringer

Hver levering er signeret, så du kan bekræfte, at den virkelig kommer fra PeekHire. Verificér signaturen på dit slutpunkt, før du stoler på payloadet, og svar med en 2xx-status for at bekræfte modtagelsen.

Gennemgang af leveringer

Visningen Leveringer viser de seneste webhook-forsøg og deres resultater, så du kan bekræfte, at hændelserne når frem, og fejlfinde et slutpunkt, der ikke svarer.

Tips

• Svar hurtigt med en 2xx, og udfør tungt arbejde asynkront.
• Gør din handler idempotent — den samme hændelse kan indimellem blive leveret mere end én gang.
• Start med et værktøj som Make, Zapier eller n8n, hvis du helst ikke vil drive en server.