generated: '2026-07-18'
method: searched
source: https://developer.codesignal.com/webhooks
spec_type: Webhooks
transport: https-post
delivery:
  method: HTTP POST
  content_type: application/json
  payload_fields:
  - event         # event type identifier
  - triggeredOn   # milliseconds since Unix epoch
  - payload       # event-specific data object
signing:
  header: X-CodeSignal-Signature
  algorithm: HMAC-SHA256
  signed_material: endpoint URL + event type + timestamp
  secret: per-endpoint secret key (optional)
events:
- name: assessmentCreated
  group: assessment
  description: A new assessment is created.
- name: assessmentUpdated
  group: assessment
  description: Assessment details change.
- name: companyTestSessionCreated
  group: assessment
  description: A test invitation is generated.
- name: companyTestSessionStarted
  group: candidate
  description: A candidate begins testing.
- name: companyTestSessionFinished
  group: candidate
  description: A non-proctored test session completes.
- name: preScreenCandidateDeclined
  group: candidate
  description: A candidate declines the invitation.
- name: preScreenResultShared
  group: candidate
  description: A candidate reuses an existing result.
- name: preScreenExpired
  group: candidate
  description: The test window closes unfulfilled.
- name: preScreenResultVerificationPending
  group: candidate
  description: A proctored test awaits review.
- name: preScreenIntegrityReviewUpdated
  group: candidate
  description: Integrity-review status changes.
- name: preScreenResultVerified
  group: auditor
  description: A proctored session is confirmed.
- name: preScreenResultNotVerified
  group: auditor
  description: A session is flagged or rejected.
- name: liveInterviewFinished
  group: live-interview
  description: A live interview concludes or times out.
- name: liveInterviewFeedbackUpdated
  group: live-interview
  description: An interviewer submits or updates evaluation feedback.