API Reference

Webhook events

Every event Ceevee emits, with payload shapes.

Every webhook payload follows the same shape: id, type, created_at, organization_id, data. The data object is event-specific.

Job events

  • job.created — A new job was created.
  • job.updated — A job's name, details, or visibility changed.
  • job.published — A draft was published to the portal.
  • job.closed — A job was closed and is no longer accepting applications.
  • job.deleted — A job was soft-deleted.

Scan events

  • scan.created — A CV was uploaded and queued.
  • scan.completed — AI extraction finished. data.profile_data is populated.
  • scan.failed — Extraction failed. data.error carries the reason.

Candidate events

  • candidate.commented — A team member or API client posted an internal comment.
  • candidate.stage_changed — The candidate moved to a different pipeline stage.
  • candidate.hired — The candidate was marked hired (terminal stage).
  • candidate.rejected — The candidate was marked rejected with optional reason.

Assessment events

  • assessment.created — Invite was generated.
  • assessment.started — Candidate opened the link and answered the first question.
  • assessment.completed — Scoring is finished. data.profile is populated.

Application events

  • application.received — A new application was submitted via the portal or a pk-authenticated widget.

Webhook health events

  • webhook.verification — Sent right after you register an endpoint, before live traffic flows.
  • webhook.test — Manually triggered via POST /v1/webhook_endpoints/{id}/test.