---
title: "Updates a Candidate"
method: PUT
path: "/api/2026-07-01/resources/ats/candidates/{id}"
tags: ["Ats > Candidate"]
---

# Updates a Candidate

`PUT /api/2026-07-01/resources/ats/candidates/{id}`

Updates ATS Candidates data

## Path parameters

- `id` string, required

## Request body

- object
  - `id` string, required — identifier of the candidate.
  - `email` string — email of the candidate.
  - `first_name` string — first name of the candidate.
  - `last_name` string — last name of the candidate.
  - `talent_pool` boolean — is the candidate part of talent pool?
  - `consent_given_at` string — date when the consent was given.
  - `phone_number` string — phone number of the candidate.
  - `personal_url` string — personal web resource from the candidate.

## Response `200`

OK

- 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.

---

[API](https://skmtc.net/factorialhr/apis/factorial-api.md) · [All operations](https://skmtc.net/factorialhr/apis/factorial-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/factorialhr/factorial-api/versions/1a6bffb20f7d/schema)