Add candidate note
Add a text note to a candidate record.
POST https://cotlet.dev/api/v1/jobadder/candidates/{candidate_id}/note
write Confirm
Adds a note to the candidate and returns its note_id and creation time. The note is plain text, visible to your team in JobAdder, and Cotlet has no tool to delete it. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate id from search_candidates. |
| text string required | string | Note text. |
Request
curl -X POST https://cotlet.dev/api/v1/jobadder/candidates/cand_20931/note \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Screening call 21 Oct. Available from 1 December, wants hybrid, salary expectation 85k."}'result = client.call("jobadder", "add_candidate_note", {"candidate_id":"cand_20931","text":"Screening call 21 Oct. Available from 1 December, wants hybrid, salary expectation 85k."})const result = await cotlet.call('jobadder', 'add_candidate_note', {"candidate_id":"cand_20931","text":"Screening call 21 Oct. Available from 1 December, wants hybrid, salary expectation 85k."});cotlet call jobadder add_candidate_note --data '{"candidate_id":"cand_20931","text":"Screening call 21 Oct. Available from 1 December, wants hybrid, salary expectation 85k."}'Example response
{
"note_id": "note_77412",
"candidate_id": "cand_20931",
"created_at": "2026-10-22T17:05:00+11:00"
}