Add candidate note
A note on a candidate profile, optionally tagging team members.
POST https://cotlet.dev/api/v1/manatal/candidates/{candidate_id}/note
write Confirm
Adds a note to the candidate's Notes tab as plain text and returns its note_id. Each name in mentions is tagged like @ in the Manatal editor and Manatal notifies that person. A name that matches no team member fails before anything is saved. 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. |
| body string required | string | Text of the note. |
| mentions array | array | Names of team members to tag, as Manatal shows them. |
Request
curl -X POST https://cotlet.dev/api/v1/manatal/candidates/48213/note \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"Strengths: portfolio depth, clear case-study writing. Concern: no B2B experience. Recommendation: second round.","mentions":["Lena Fischer"]}'result = client.call("manatal", "add_candidate_note", {"candidate_id":48213,"body":"Strengths: portfolio depth, clear case-study writing. Concern: no B2B experience. Recommendation: second round.","mentions":["Lena Fischer"]})const result = await cotlet.call('manatal', 'add_candidate_note', {"candidate_id":48213,"body":"Strengths: portfolio depth, clear case-study writing. Concern: no B2B experience. Recommendation: second round.","mentions":["Lena Fischer"]});cotlet call manatal add_candidate_note --data '{"candidate_id":48213,"body":"Strengths: portfolio depth, clear case-study writing. Concern: no B2B experience. Recommendation: second round.","mentions":["Lena Fischer"]}'Example response
{
"note_id": 9187,
"candidate_id": 48213,
"tagged": [
"Lena Fischer"
],
"created_at": "2026-10-20T10:12:00Z"
}