---
title: "Position opening deleted webhook"
method: POST
path: "positionOpeningDeleted"
tags: ["Workforce Planning Webhooks"]
---

# Position opening deleted webhook

`POST positionOpeningDeleted` (webhook)

Webhook sent when a position opening is removed. Position openings are always linked
to a Position in Bob.

**Best practice:** Use the event as a notification only, and verify the deletion using the
<a href="https://apidocs.hibob.com/reference/post_positions-position-openings-search" target="_blank">Read company positions openings</a> API endpoint.

In the right panel, open **Examples** and select **Payload Example** to see a real payload.

## Headers

- `bob-signature` string, required

## Payload

- PositionOpeningDeletedEvent: Webhook sent when a position opening is removed.
  - `companyId` number, required: The company ID
  - `type` 'workforcePlanning.positionOpening.deleted', required: The event type for position opening deletion
  - `triggeredBy` string, required: The backend-id of the employee that triggered the event or 'system' for events triggered automatically by the system
  - `triggeredAt` string, date-time, required: The timestamp when the event occurred
  - `version` string, required: The webhook version
  - `data` object, required: Contains the actual data and differs for each event type
    - `positionOpeningId` number, required: The ID of the deleted position opening

## Acknowledgement `200`

Webhook received successfully

## Other responses

- `400`: Invalid webhook payload

---

[API](https://skmtc.dev/hibob/apis/workforce-planning-api.md) - [All operations](https://skmtc.dev/hibob/apis/workforce-planning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/workforce-planning-api/revisions/07e0d5841251?raw)
