jobs

Create an application for a job

If candidate does not exist (search by mail) it will be created, otherwise the application will be added to the existing candidate.<br/><b>Use this endpoint to create a candidate application to a job offer (with answers to the job questions). To link an existing candidate to a job offer, use the '/jobs/{jobId}/candidates' or the '/candidates/{candidateId}/jobs' endpoints.</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 'job.application.create' scope activated on your secret key.

post/0/jobs/{id}/applications

Request

  • Base URL: https://api.taleez.com
  • URL: https://api.taleez.com/0/jobs/{id}/applications
  • Auth: API key in header X-taleez-api-secret

Path parameters

idstring required

Id of the job

Request body

firstNamestring required

Candidate first name

lastNamestring required

Candidate last name

emailstring

Candidate e-mail

phonestring

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

initialReferrerstring

Application initial referer. Default : 'API Taleez'

bypassRequiredQuestionsboolean

True to allow required questions to do not have answer

locationIdinteger

Id of the location if necessary

Example request

{
  "firstName": "Paul",
  "lastName": "Lefebvre",
  "email": "p.lefebvre@provider.com",
  "phone": "0611223344",
  "initialReferrer": "My web site",
  "locationId": 817,
  "answers": [
    {
      "questionId": 654167,
      "value": "My answer",
      "choices": [
        5487,
        9873
      ],
      "starValues": [
        {
          "id": 46577,
          "value": 3
        }
      ],
      "docTempId": "31ccd003-77e7-46af-9c88-07b71f54a90a",
      "docData": "JVBERi0xLjUKJcOkw7zDtsO..."
    }
  ]
}

Response

Application has been created

Changes

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