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

# Create Position Opening

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

## Request

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

Creates a new position opening within a position <br><br> **Limitations:** <br> - You can create up to 10 position openings per request. <br> - If the request includes more than 10 position openings, the operation will fail and return an error. <br><br> **Notes:**<br> - For fields that require reference to a list in Bob, use the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname">metadata endpoint</a> to fetch list values.<br>

## Path parameters

- `positionId` number, required

## Request body

- PublicPositionOpeningCreateRequest
  - `items` PublicPositionOpeningCreateItem[], required
    - `objectType` 'positionOpening', required
    - `fields` PublicPositionOpeningCreate, required
      - `/positionOpening/positionOpeningName` object: A unique identifier for each opening within a position. Using the API you can provide the name that reflects the format chosen by your organization. If not passed, the system will automatically fill this out.
        - `value` string, nullable
      - `/positionOpening/expectedStartDate` object, required: The expected start date is the realistic forecast of the date on which the position should be filled. This is a mandatory field.
        - `value` string, date, required
      - `/positionOpening/recruitmentStatus` object: A list of possible recruitment status for the position opening. Out-of-the-box values include: `open`, `onHold`, and `closed` (list name: `recruitmentStatus`).
        - `value` string, nullable

## Response `200`

Position opening created successfully

- PositionWithOpeningResponse
  - `id` number: The ID of the created position
  - `positionOpeningId` number: The ID of the created position opening

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