Add candidate
Create a candidate on a position.
POST https://cotlet.dev/api/v1/comeet/positions/{position_id}/candidates
write Confirm
Creates a candidate with the fields Recruit requires: full name, source, position and posting location. Email, phone, salary expectations and availability are optional. It does not check for duplicates, so search with list_candidates first. Email templates that fire on workflow steps still apply, so the candidate may hear from Recruit. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| full_name string required | string | Candidate's full name. |
| position_id string required | string | Position from list_positions. |
| source string required | string | Source name as Recruit lists it. |
| posting_location string required | string | One of the position's posting locations. |
| email string | string | Candidate email. |
| phone string | string | Candidate phone. |
Request
curl -X POST https://cotlet.dev/api/v1/comeet/positions/position_8c41d2/candidates \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"full_name":"Jane Doe","source":"source","posting_location":"posting location"}'result = client.call("comeet", "add_candidate", {"full_name":"Jane Doe","position_id":"position_8c41d2","source":"source","posting_location":"posting location"})const result = await cotlet.call('comeet', 'add_candidate', {"full_name":"Jane Doe","position_id":"position_8c41d2","source":"source","posting_location":"posting location"});cotlet call comeet add_candidate --data '{"full_name":"Jane Doe","position_id":"position_8c41d2","source":"source","posting_location":"posting location"}'Example response
{
"candidate_id": "cand_8e44b0",
"name": "Ana Lopez",
"position": "Backend Engineer",
"source": "Referral",
"status": "in_progress",
"current_step": "Application review"
}