---
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`

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.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/versions/0781ebbdda91/schema)