---
title: "Creates a Candidate"
method: POST
path: "/api/2026-10-01/resources/ats/candidates"
tags: ["Ats > Candidate"]
---

# Creates a Candidate

`POST /api/2026-10-01/resources/ats/candidates`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/ats/candidates`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `recruitment`
  - API key in header `x-api-key`

Creates candidates related to a particular company in an ATS

## Request body

- object
  - `first_name` string, required: first name of the candidate.
  - `last_name` string, required: last name of the candidate.
  - `email` string: email of the candidate.
  - `company_id` string, required: company identifier, refers to /core/me endpoint.
  - `talent_pool` boolean: is the candidate part of talent pool?
  - `consent_given_at` string: date when the consent was given.
  - `source` string: source of the candidate.
  - `medium` string: specifies additional details related to the source of the candidate, such as the referrer name for example if the source is referred.
  - `phone_number` string: phone number of the candidate.
  - `personal_url` string: personal web resource from the candidate.
  - `gender` string: gender of the candidate.

## Response `201`

CREATED

- AtsCandidate
  - `id` string, required: identifier of the candidate.
  - `company_id` string: company identifier.
  - `first_name` string, required: name of the candidate.
  - `last_name` string, required: last name of the candidate.
  - `full_name` string, required: full name of the candidate.
  - `email` string: email of the candidate.
  - `talent_pool` boolean, required: is the candidate part of talent pool?
  - `phone_number` string: phone number of the candidate.
  - `created_at` string, required: creation date of the candidate.
  - `updated_at` string, required: last update of the candidate.
  - `consent_given_at` string: date when the consent was given.
  - `inactive_since` string: date when the candidate became inactive.
  - `ats_job_posting_ids` string[]: list of job posting identifiers.
  - `personal_url` string: personal web resource from the candidate.
  - `consent_expiration_date` string: date when the consent expires.
  - `consent_to_talent_pool` boolean: consent to talent pool.
  - `medium` string: specifies additional details related to the source of the candidate, such as the referrer name for example if the source is referred.
  - `source_id` string: candidate source identifier, refers to ats/candidate_sources endpoint.
  - `gender` 'female' | 'male' | 'unanswered' | 'other': gender of the candidate.
  - `score` number: score of the candidate.

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/ats/candidates/post.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)