Webhookar

Webhooks skickar ett litet meddelande till en URL som du kontrollerar när något händer i PeekHire — så att du kan reagera i realtid i stället för att polla API.

Så fungerar webhooks

1. Du skapar en slutpunkt (en URL på din server eller i ett automationsverktyg) under Utvecklarverktyg → webhooks.
2. Du väljer vilka händelser den ska ta emot.
3. När en händelse inträffar skickar PeekHire en HTTP POST med en JSON-payload till din slutpunkt.

Payloads är avsiktligt små — de visar vad som har hänt och vilket objekt det gäller, så att du kan hämta fullständig information från REST API om du behöver det.

Tillgängliga händelser

Händelser täcker rekryteringslivscykeln, inklusive:

• Ansökningar — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Ansökningskommentarer — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampanjer — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Verifiera leveranser

Varje leverans signeras så att du kan bekräfta att den verkligen kom från PeekHire. Verifiera signaturen på din slutpunkt innan du litar på payloaden och svara med en 2xx-status för att bekräfta mottagandet.

Granska leveranser

Vyn Leveranser visar senaste webhook-försök och deras resultat, så att du kan bekräfta att händelser kommer fram och felsöka en slutpunkt som inte svarar.

Tips

• Svara snabbt med en 2xx och gör tyngre arbete asynkront.
• Gör din hanterare idempotent — samma händelse kan ibland levereras mer än en gång.
• Börja med ett verktyg som Make, Zapier eller n8n om du helst inte vill köra en server.