Webhooks

Webhooks will let your systems react to hiring events in real time, instead of polling.

Planned events

• candidate.assessed — an evaluation completed for a candidate.
• candidate.advanced — a candidate moved to a new stage.
• interview.scheduled — a live interview was booked.
• offer.signed — a candidate signed their offer.

Payload

Every delivery shares a common envelope:

{
  "id": "evt_123",
  "type": "candidate.assessed",
  "created": "2026-07-19T00:00:00Z",
  "data": {
    "candidate_id": "cand_456",
    "job_id": "job_789"
  }
}

Verifying signatures

Each delivery will include a signature header derived from a shared secret, so you can confirm a request genuinely came from Prosli before trusting it. Verify the signature, then respond 2xx quickly and process asynchronously.

Retries

Failed deliveries (non-2xx, or a timeout) will be retried with exponential backoff, so your endpoint should be idempotent on the event id.