---
title: "Background check cancelled"
method: POST
path: "backgroundCheckCancelled"
tags: ["Background check webhooks"]
---

# Background check cancelled

`POST backgroundCheckCancelled` (webhook)

Fired when a recruiter cancels an in-flight or pending background
check in Bob. Partners stop processing at the provider and do not call PATCH
for a terminal status unless product guidance says otherwise.

Delivery is at-least-once — partners handle duplicates idempotently using
`data.backgroundCheckRequestId`. The cancelled payload does not include
`packageId`.

Every webhook request carries a `bob-signature` header that partners verify
before processing. See HiBob's
<a href="https://apidocs.hibob.com/reference/getting-started-webhooks#how-does-bob-calculate-the-signature">webhook signature verification guide</a>.

## Headers

- `bob-signature` string, required

## Payload

- BackgroundCheckCancelledPayload
  - `version` string, required: Webhook payload schema version. Currently always `"v2"`.
  - `type` 'backgroundCheck.cancelled', required
  - `triggeredBy` string, required: Backend ID of the employee who triggered the event, or `system`.
  - `triggeredAt` string, required: When the event occurred, as an ISO 8601 timestamp with `Z` suffix (for example `"2026-05-28T11:00:00Z"`).
  - `data` BackgroundCheckCancelledData, required
    - `backgroundCheckRequestId` string, required: Background check ID that was cancelled in Bob.

## Acknowledgement `200`

Webhook received successfully

## Other responses

- `400`: Invalid webhook payload

---

[API](https://skmtc.dev/hibob/apis/bob-hiring-partners-api.md) - [All operations](https://skmtc.dev/hibob/apis/bob-hiring-partners-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/bob-hiring-partners-api/revisions/50feb9493b32?raw)