Add candidate to job
Links a candidate to a job so they show in its pipeline.
POST https://cotlet.dev/api/v1/manatal/jobs/{job_id}/candidates/{candidate_id}/to-job
write Confirm
Adds the candidate to the job, like Add Candidate on the job page, and returns the match_id. A candidate who is already on the job fails with a clear error, and one candidate can be on several jobs. Use move_candidate_stage to place the match in a stage. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id integer required | integer | Candidate ID from search_candidates. |
| job_id integer required | integer | Job ID from search_jobs. |
Request
curl -X POST https://cotlet.dev/api/v1/manatal/jobs/3107/candidates/48213/to-job \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("manatal", "add_candidate_to_job", {"candidate_id":48213,"job_id":3107})const result = await cotlet.call('manatal', 'add_candidate_to_job', {"candidate_id":48213,"job_id":3107});cotlet call manatal add_candidate_to_job --data '{"candidate_id":48213,"job_id":3107}'Example response
{
"match_id": 55140,
"candidate_id": 48213,
"job_id": 3107,
"added_to_job_on": "2026-10-20"
}