candidates

Add a candidate

<b>Use this endpoint for sourcing use case, to create a new candidate from his personal information (names, mail...). To create a candidate application (with answers to the job questions) to a job offer, use the '/jobs/{jobId}/applications' endpoint.</b><br/>Currently, automatic actions (workflow, automatic e-mails and webhooks) are not triggered by this way.<br/><br/>🔑 You can access this if you have the 'candidate.create' scope activated on your secret key.

post/0/candidates

Request

  • Base URL: https://api.taleez.com
  • URL: https://api.taleez.com/0/candidates
  • Auth: API key in header X-taleez-api-secret

Request body

firstNamestring required
lastNamestring required
mailstring

Candidate mail. If specified, must be unique in your company.

phonestring

Candidate phone (formats : 0611223344, +33611223344, 00336112233). Ignored if not valid.

initialReferrerstring

Candidate source.

lang'FR' | 'EN' | 'ES' | 'IT'

Candidate lang (lang must be activated in your account)

recruiterIdinteger

Id of the recruiter who add this candidate. If specified, the candidate will appear as added by this recruiter in Taleez.

unitIdinteger

Id of the unit to be associated with the candidate. Only usable (and required) for companies with multiple units and "candidate segmentation by unit" setting (for other companies, the value is ignored)

Example request

{
  "firstName": "John",
  "lastName": "Doe",
  "mail": "john.doe@gmail.com",
  "phone": "0611223344",
  "initialReferrer": "My web site",
  "lang": "FR",
  "recruiterId": 5489,
  "unitId": 5489,
  "location": {
    "country": "FR",
    "city": "Toulouse",
    "street": "Place du Capitole"
  }
}

Response

Return the id of the created candidate

Changes

No recorded changes to this operation across all 1 revision of this API.