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

# Position opening created webhook

`POST positionOpeningCreated` (webhook)

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

They allow organizations to plan multiple hiring scenarios under the same position (e.g.
maternity leave replacements or organizational growth) without duplicating positions. Each
opening can have its recruitment status, expected start date, and opening name.

**Best practice:** Use the event as a notification only, and retrieve the complete position
opening details using the <a href="https://apidocs.hibob.com/reference/post_positions-position-openings-search" target="_blank">Read company positions openings</a> API endpoint.
Note that position opening events don't include the position ID; you can get it by
retrieving the opening details.

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

## Headers

- `bob-signature` string, required

## Payload

- PositionOpeningCreatedEvent: Webhook sent when a new position opening is created.
  - `companyId` number, required: The company ID
  - `type` 'workforcePlanning.positionOpening.created', required: The event type for position opening creation
  - `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 created 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)