---
title: "Create Job Opening"
method: POST
path: "/api/v1/applicant_tracking/job_opening"
tags: ["Applicant Tracking", "Public API"]
---

# Create Job Opening

`POST /api/v1/applicant_tracking/job_opening`

Create a new job opening. The authenticated caller must have access to ATS settings. Use the Get Company Locations and Get Hiring Leads endpoints to obtain valid IDs for `jobLocation` and `hiringLead`. On success, returns the new job opening ID.

## Response `200`

Success. Returns the result status and the new job opening ID.

- object
  - `result` string — Always 'success' on a successful request
  - `jobOpeningId` string — The ID of the newly created job opening

## Other responses

- `401` — Unauthorized. Invalid API credentials.
- `403` — Insufficient user permissions or API access is not turned on.
- `404` — Bad request url.
- `422` — Unprocessable entity. One or more parameters failed validation.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)