Webhooks

Webhooks senden eine kleine Nachricht an eine von dir kontrollierte URL, sobald in PeekHire etwas passiert – so reagierst du in Echtzeit, statt die API abzufragen.

So funktionieren Webhooks

1. Du erstellst unter Entwickler-Tools → Webhooks einen Endpunkt (eine URL auf deinem Server oder in einem Automatisierungstool).
2. Du wählst, welche Events er empfangen soll.
3. Tritt ein Event ein, sendet PeekHire ein HTTP-POST mit JSON-Payload an deinen Endpunkt.

Payloads sind bewusst klein – sie nennen, was passiert ist und welches Objekt betroffen ist. Details holst du bei Bedarf über die REST-API.

Verfügbare Events

Events decken den Recruiting-Lebenszyklus ab, darunter:

• Bewerbungen – application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Bewerbungskommentare – application.comment.created, application.comment.updated, application.comment.deleted.
• Kampagnen – campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Zustellungen verifizieren

Jede Zustellung ist signiert, damit du bestätigen kannst, dass sie wirklich von PeekHire stammt. Prüfe die Signatur, bevor du der Payload vertraust, und antworte mit 2xx, um den Empfang zu bestätigen.

Zustellungen prüfen

Die Ansicht Zustellungen zeigt jüngste Versuche und Ergebnisse – so siehst du, ob Events ankommen, und debuggst einen Endpunkt, der nicht antwortet.

Tipps

• Antworte schnell mit 2xx und erledige schwere Arbeit asynchron.
• Mache deinen Handler idempotent – dasselbe Event kann mehrfach kommen.
• Starte mit Make, Zapier oder n8n, wenn du keinen Server betreiben willst.