Sign in
Webhooks

Register a webhook

Register a webhook URL to receive event notifications. The response includes a signing_secret (whsec_…) that is returned only once — store it securely. All subsequent deliveries are signed with this secret via HMAC-SHA256.

post/api/v2/webhooks

Headers

X-API-KEYstring nullable
Authorizationstring nullable
X-Workspace-Idstring nullable

Request body

posting_idstring required

ID of the posting this webhook is for.

webhook_urlstring required

Destination URL for webhook delivery.

event_typestring required

Type of event that triggers the webhook. Supported values: 'interview_started', 'interview_completed', 'report_available', 'candidate_shortlisted', 'candidate_rejected'.

Example request

{
  "posting_id": "13D77095",
  "webhook_url": "https://webhook.site/test",
  "event_type": "interview_completed"
}

Response

Successful Response

metaobject nullable

Optional metadata. Shape varies by endpoint.

Example response

{
  "data": {
    "webhook_id": "42AE4CFA720B1C35D499E9E39C14F321",
    "posting_id": "13D77095",
    "webhook_url": "https://webhook.site/test",
    "event_type": "interview_completed",
    "created_at": 1739612400,
    "updated_at": 1739617200,
    "signing_secret": "whsec_a1b2c3d4e5f6..."
  }
}

Changes