Candidates are created by making a POST request to the RecruiterFlow public API.
Convert does not allow the creation of job applications on which the candidate has not agreed to the privacy statement and terms of service.
The same candidate can apply to different job posts since candidates are connected with the job post by ID. If a candidate is already in the pipeline we can still update its application with the screening questions and files attached.
When updating a candidate it is enough to change the endpoint from candidate/add to candidate/update and send candidate ID in the request since this API implements a complete update, meaning that any existing data in the provided ID will be wiped out and replaced with the data provided.
Example request to the RecruiterFlow API:
curl -X POST "https://recruiterflow.com/api/external/candidate/add" \
-H "accept: application/json" \
-H "RF-Api-Key: API_KEY" \
-H "Content-Type: application/json" \
-d "{
"name": "swagger candidate",
"email": [
{
"email": "[email protected]",
"is_primary": 1
}
],
"phone_number": [
{
"phone_number": "987689928",
"type": 1
}
],
"custom_fields": [
{
"id": 16,
"value": {
"currency": "USD",
"number": 600000
}
},
{
"id": 17,
"value": {
"currency": "USD",
"number1": 600000,
"number2": 800000
}
},
{
"id": 19,
"value": {
"number1": 600000,
"number2": 800000
}
},
{
"id": 20,
"value": [
"choice1",
"choice2"
]
},
{
"id": 33,
"value": "Random"
}
]
}"