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

# Position budget updated webhook

`POST positionBudgetUpdated` (webhook)

Webhook sent when position budget fields are modified. Position budgets are always linked
to a Position in Bob.

They allow tracking of the financial allocation for specific roles within the organization.
The payload includes `fieldUpdatesIds` to indicate which fields were changed.

**Best practice:** Use the event as a notification only, and retrieve the complete position
budget details using the <a href="https://apidocs.hibob.com/reference/post_positions-position-budget-search" target="_blank">Read company positions budgets</a> API endpoint.
Use the `fieldUpdatesIds` from the payload to retrieve only the updated field values. Note
that budget events include the position ID, because budget details don't return it.

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

## Headers

- `bob-signature` string, required

## Payload

- PositionBudgetUpdatedEvent: Webhook sent when position budget fields are modified. The event payload includes the position ID that this budget is linked to.
  - `companyId` number, required: The company ID
  - `type` 'workforcePlanning.positionBudget.updated', required: The event type for position budget 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
    - `positionBudgetId` number, required: The ID of the updated position budget
    - `positionId` number, required: The ID of the position this budget is linked to
    - `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)