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

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