---
title: "Position updated webhook"
method: POST
path: "positionUpdated"
tags: ["Workforce Planning Webhooks"]
---

# Position updated webhook

`POST positionUpdated` (webhook)

Webhook sent when any position fields are modified in the Workforce Planning module.

Positions can have various attributes such as department, site, employment type, and manager.
The payload includes `fieldUpdatesIds` to indicate which fields were changed.

**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.
Use the `fieldUpdatesIds` from the payload to retrieve only the updated field values.

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

## Headers

- `bob-signature` string, required

## Payload

- PositionUpdatedEvent: Webhook sent when any position fields are modified in the Workforce Planning module.
  - `companyId` number, required: The company ID
  - `type` 'workforcePlanning.position.updated', required: The event type for position update
  - `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 updated position
    - `fieldUpdatesIds` FieldId[], required: List of field paths that were updated
      - `id` string, required: The field path (e.g., /position/status)

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