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

# Position created webhook

`POST positionCreated` (webhook)

Webhook sent when a new position is created in the Workforce Planning module.

Positions are a core entity of the Workforce Planning module, enabling you to allocate
budgets and assign specific roles to positions for your workforce's current and future needs.

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

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

## Headers

- `bob-signature` string, required

## Payload

- PositionCreatedEvent: Webhook sent when a new position is created in the Workforce Planning module.
  - `companyId` number, required: The company ID
  - `type` 'workforcePlanning.position.created', required: The event type for position 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
    - `positionId` number, required: The ID of the created position

## 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)