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

# Position budget created webhook

`POST positionBudgetCreated` (webhook)

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

They allow tracking of the financial allocation for specific roles within the organization.
Budget attributes include the budget date (when funding starts), currency, base salary, and
variable pay. Budgets are available only if you activate the position cost feature in the
workforce planning settings.

**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.
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

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

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