---
title: "Changes to Create Candidate"
method: POST
path: "/api/ats/v1/candidates"
---

# Changes to Create Candidate

`POST /api/ats/v1/candidates`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 23 revisions.

- **2026-10-06** `1f9bc0ad4bfb`: 21 breaking, 3 info
- **2026-09-27** `cf8209fb1cd7`: 1 warning, 1 info
- **2026-08-24** `a606b0cf18c9`: 9 info
- **2026-08-01** `eb3486b88e55`: 3 info

## Changes

- **2026-10-06** `1f9bc0ad4bfb`: 21 breaking, 3 info
  - removed the enum value `-` of the request property `anyOf[subschema #1: CreateCandidate]/data/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `-` of the request property `anyOf[subschema #2: AtsCandidateWrite]/attachments/anyOf[subschema #1]/items/attachment_type`
  - removed the enum value `-` of the request property `anyOf[subschema #2: AtsCandidateWrite]/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `BLOG` of the request property `anyOf[subschema #1: CreateCandidate]/data/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `BLOG` of the request property `anyOf[subschema #2: AtsCandidateWrite]/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `COMPANY` of the request property `anyOf[subschema #1: CreateCandidate]/data/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `COMPANY` of the request property `anyOf[subschema #2: AtsCandidateWrite]/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `COVER_LETTER` of the request property `anyOf[subschema #2: AtsCandidateWrite]/attachments/anyOf[subschema #1]/items/attachment_type`
  - removed the enum value `JOB_POSTING` of the request property `anyOf[subschema #1: CreateCandidate]/data/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `JOB_POSTING` of the request property `anyOf[subschema #2: AtsCandidateWrite]/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `OFFER_LETTER` of the request property `anyOf[subschema #2: AtsCandidateWrite]/attachments/anyOf[subschema #1]/items/attachment_type`
  - removed the enum value `OTHER` of the request property `anyOf[subschema #1: CreateCandidate]/data/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `OTHER` of the request property `anyOf[subschema #2: AtsCandidateWrite]/attachments/anyOf[subschema #1]/items/attachment_type`
  - removed the enum value `OTHER` of the request property `anyOf[subschema #2: AtsCandidateWrite]/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `PERSONAL` of the request property `anyOf[subschema #1: CreateCandidate]/data/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `PERSONAL` of the request property `anyOf[subschema #2: AtsCandidateWrite]/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `PORTFOLIO` of the request property `anyOf[subschema #1: CreateCandidate]/data/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `PORTFOLIO` of the request property `anyOf[subschema #2: AtsCandidateWrite]/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `RESUME` of the request property `anyOf[subschema #2: AtsCandidateWrite]/attachments/anyOf[subschema #1]/items/attachment_type`
  - removed the enum value `SOCIAL_MEDIA` of the request property `anyOf[subschema #1: CreateCandidate]/data/urls/anyOf[subschema #1]/items/url_type`
  - removed the enum value `SOCIAL_MEDIA` of the request property `anyOf[subschema #2: AtsCandidateWrite]/urls/anyOf[subschema #1]/items/url_type`
  - the endpoint scheme security `HTTPBearer AND ConnectorToken` was added to the API
  - the endpoint scheme security `ConnectorToken` was removed from the API
  - the endpoint scheme security `HTTPBearer` was removed from the API
- **2026-09-27** `cf8209fb1cd7`: 1 warning, 1 info
  - deleted the `header` request parameter `x-connector-token`
  - the endpoint scheme security `ConnectorToken` was added to the API
- **2026-08-24** `a606b0cf18c9`: 9 info
  - the `applications` request property default value `` was removed
  - the `attachments` request property default value `` was removed
  - the `email_addresses` request property default value `` was removed
  - the `locations` request property default value `` was removed
  - the `phone_numbers` request property default value `` was removed
  - the `tags` request property default value `` was removed
  - the `urls` request property default value `` was removed
  - request property `anyOf[subschema #1: CreateCandidate]/job_requisition_id` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `anyOf[subschema #1: CreateCandidate]/remote_user_id` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-08-01** `eb3486b88e55`: 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`

---

[Operation](https://skmtc.dev/bindbee/apis/bindbee-apis/docs/api/ats/v1/candidates/post.md) - [API](https://skmtc.dev/bindbee/apis/bindbee-apis.md) - [Page](https://skmtc.dev/bindbee/apis/bindbee-apis/changes/api/ats/v1/candidates/post)