Skip to main content

Worker Recruitment Stage Updated

Event Type​

requisition_worker_stage_updated

Summary​

Sent after a worker recruitment stage is manually updated, including the Mark CV reviewed action. Automatic stage changes on submission or assignment do not trigger this event. Failed requests and requests that leave the worker at the same stage do not trigger it.

Company-scoped webhooks and webhooks belonging to the agency that submitted the affected worker can subscribe. Other agencies do not receive the event.

Fetch the Full Object​

The payload contains the requisition's full object ID in data.requisition.id. Use that id as the {id} path parameter on GET /requisitions/{id} to fetch the latest requisition, worker stages and stage history. The payload identifies the requisition; it does not contain a snapshot of the stage change.

Delivery​

  • Method: POST
  • Content-Type: application/json
  • Delivery guarantee: at-least-once

Payload Fields​

FieldTypeRequiredDescription
idstringYesUnique webhook event id
typestringYesrequisition_worker_stage_updated
createdAtstringYesEvent creation timestamp
dataobjectYesEvent data
data.requisitionobjectYesRequisition reference
data.requisition.idstringYesFull object ID for the requisition

Payload Example​

{
"id": "evt_01K1REQSTAGEUPDATED9S8T7U6",
"type": "requisition_worker_stage_updated",
"createdAt": "2026-08-17T09:45:00.000Z",
"data": {
"requisition": {
"id": "507f1f77bcf86cd799439011"
}
}
}