Add candidates to a job
Add one or more candidates to an open job, in its first stage.
POST https://cotlet.dev/api/v1/recruiterflow/jobs/{job_id}/candidate-to-jobs
write
Adds candidates to one open job. Closed and on-hold jobs are refused, as they are missing from the dropdown in Recruiterflow. Each candidate enters the default first stage of the job's pipeline. Candidates already on the job are not duplicated and keep their stage; they come back in already_on_job. Automations an admin set on that stage still run.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id string required | string | Open job id from list_jobs. |
| candidate_ids array required | array | Candidate ids from list_candidates. |
Request
curl -X POST https://cotlet.dev/api/v1/recruiterflow/jobs/job_8c41d2/candidate-to-jobs \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"candidate_ids":"candidate ids"}'result = client.call("recruiterflow", "add_candidate_to_job", {"job_id":"job_8c41d2","candidate_ids":"candidate ids"})const result = await cotlet.call('recruiterflow', 'add_candidate_to_job', {"job_id":"job_8c41d2","candidate_ids":"candidate ids"});cotlet call recruiterflow add_candidate_to_job --data '{"job_id":"job_8c41d2","candidate_ids":"candidate ids"}'Example response
{
"job_id": "48213",
"stage": "Sourced",
"added": [
"772455",
"772456"
],
"already_on_job": [
"771204"
]
}