---
title: "Create Position Budget"
method: POST
path: "/workforce-planning/positions/{positionId}/position-budget"
tags: ["Workforce Planning"]
---

# Create Position Budget

`POST /workforce-planning/positions/{positionId}/position-budget`

## Request

- Base URL: `https://api.hibob.com/v1`
- URL: `https://api.hibob.com/v1/workforce-planning/positions/{positionId}/position-budget`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Creates a specific position budget within a position **Limitations:** <br> - You can create up to 1 budget per request. <br> - If the request includes more than 1 budget, the operation will fail and return an error. <br><br>

## Path parameters

- `positionId` number, required

## Request body

- PublicPositionBudgetCreateRequest
  - `items` PublicPositionBudgetCreateItem[], required
    - `objectType` 'positionBudget', required
    - `fields` PublicPositionBudgetCreate, required
      - `/positionBudget/expectedBaseSalaryCurrencyValue` object: The expected base salary is the fixed amount of money allocated as regular compensation for a position, not including bonuses or other variable pay.
        - `value` number, nullable
      - `/positionBudget/salaryPayPeriod` object, required: Specifies the frequency and timing of salary payments for this budget, such as monthly or weekly. The possible values are a list in Bob (list name: `payPeriod`)
        - `value` 'Annual' | 'Annual 13' | 'Annual 14' | 'Hourly' | 'Daily' | 'Weekly' | 'Monthly' | 'Monthly 13' | 'Monthly 14' | 'Quarterly', required
      - `/positionBudget/totalPositionCostCurrencyValue` object: The total position cost related to this budget.
        - `value` number, nullable
      - `/positionBudget/currency` object, required: The currency of the position budget. To obtain the available currency codes, call the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname"> Get all company lists Metadata API</a> with `currency` in the listname path parameter.
        - `value` string, required
      - `/positionBudget/variablePayPeriod` object
        - `value` 'Quarterly' | 'Monthly' | 'Half-Yearly' | 'Annual', required
      - `/positionBudget/expectedVariablePayCurrencyValue` object
        - `value` number, required

## Response `200`

Position budget created successfully

- PublicPositionBudgetCreateResponse
  - `positionBudgetId` number: The ID of the created budget

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

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