Create Position
Creates new positions with associated position opening and optional position budget. <br><br> Limitations: <br> - You can create up to 10 positions per request. <br> - If the request includes more than 10 positions, the operation will fail and return an error. <br><br> Notes:<br> - When creating a Position, the position opening is mandatory.<br> - Position budget is optional and will be created only if the service user has the required permission.<br> - The endpoint will return the ID of the positions and the position opening that were created. To find out the budget ID you should read the position details.<br> - Currently, you cannot create "position requests" that require an approval flow, which are not supported via the API.<br> - This endpoint requires linking the position to a job profile, and can be used only with Job Catalog 2.0. To retrieve the jobProfile, use the <a href="https://apidocs.hibob.com/reference/job-catalog">Job Catalog API</a>.<br> - For fields that require reference to a list in Bob (e.g. department), use the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname">metadata endpoint</a> to fetch list values.<br> - For custom fields, use the Examples > Request Example, and copy to an external API client tool to add custom fields to the payload.<br>
Request body
Example request
{
"items": [
{
"fields": {
"/position/effectiveDate": {
"value": "2025-04-01"
},
"/position/positionOpening": {
"fields": {
"/positionOpening/expectedStartDate": {
"value": "2025-04-01"
}
}
}
}
}
]
}Response
Position request created successfully