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

# Create Candidate

`POST /api/v1/applicant_tracking/application`

Create a new candidate application for a job opening. The authenticated caller must have access to ATS settings. On success, returns the new candidate ID. Only fields required by the target job opening's standard questions need to be provided beyond firstName, lastName, and jobId.

OAuth Scopes: hiring:applications.write

## Response `200`

Success. Returns the result status and the new candidate ID.

- object
  - `result` string — Always 'success' on a successful request
  - `candidateId` integer — The ID of the newly created candidate

## 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.
- `429` — Too Many Requests - Rate limit exceeded.

---

[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/versions/19ebf391a399/schema)