Add candidates to a job
Add one or more candidates to an open job, in its first stage.
MCP tool recruiterflow_write → add_candidate_to_job
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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "recruiterflow_write",
"arguments": {
"operation": "add_candidate_to_job",
"arguments": {
"job_id": "job_8c41d2",
"candidate_ids": "candidate ids"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"job_id": "48213",
"stage": "Sourced",
"added": [
"772455",
"772456"
],
"already_on_job": [
"771204"
]
},
"isError": false
}