GuidesAPI ReferenceChangelog
API Reference
These docs are for v2025-10-01. Click to read the latest docs for v2026-04-01.

Creates a Candidate

post
https://api.factorialhr.com/api/2025-10-01/resources/ats/candidates

Creates candidates related to a particular company in an ATS

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

first name of the candidate.

string
required

last name of the candidate.

string

email of the candidate.

integer
required

company identifier, refers to /core/me endpoint.

boolean

is the candidate part of talent pool?

string

date when the consent was given.

string

source of the candidate.

string

specifies additional details related to the source of the candidate, such as the referrer name for example if the source is referred.

string

phone number of the candidate.

string

personal web resource from the candidate.

string

gender of the candidate.

Response

Updated 7 months ago

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 months ago