Create new candidate

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

The candidate status. Must be one of the statuses configured for the company — use the GET endpoint /candidates/statuses to list them. Matching ignores casing and spacing. Defaults to AVAILABLE when omitted.

string
string
string
string
tags
array of strings
tags
string
string

The URL for the uploaded resume. Use the POST endpoint /file/resume to parse and upload the resume. The file is fetched and attached to the candidate as a document, and the URL itself is stored on the candidate. A URL that cannot be reached is skipped and logged; it never fails the request. The resume is not parsed by this endpoint, so keep sending the candidate’s details in this same body.

languages
array of objects
languages
skills
array of objects
skills
workExperiences
array of objects
workExperiences
educations
array of objects
educations
certifications
array of objects
certifications
locationIds
array of strings
locationIds
Headers
string
required

API key generated in the app. Write permissions are required.

Responses

400

No email has been provided, or the status is not one of the company’s configured statuses

401

No or an invalid API key was set

409

Candidate has already been created

500

Internal error

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