Add candidate note
Adds a note with a Note Action to a candidate's Notes tab.
POST https://cotlet.dev/api/v1/bullhorn/candidates/{candidate_id}/notes
write Confirm
Saves one plain-text note on the candidate, as Actions > Add Note does. note_action must be one of the values your admin set, at most 30 characters. A name typed after @ in comments emails that user when the note is saved, so the note can reach other people. Returns the note_id. 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 or find_matching_candidates. |
| comments string required | string | Note text, plain text only. @name tags a user, #name references a record. |
| note_action string required | string | Note Action value such as Phone Call, Email or Internal Memo, as set in your account. |
| job_id integer | integer | Job to reference in the note. |
Request
curl -X POST https://cotlet.dev/api/v1/bullhorn/candidates/4821907/notes \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"note_action":"Phone Call","comments":"Open to contract at 90 USD/h, free from 3 Nov. Not relocating. Send the Northwind data role."}'result = client.call("bullhorn", "add_note", {"candidate_id":4821907,"note_action":"Phone Call","comments":"Open to contract at 90 USD/h, free from 3 Nov. Not relocating. Send the Northwind data role."})const result = await cotlet.call('bullhorn', 'add_note', {"candidate_id":4821907,"note_action":"Phone Call","comments":"Open to contract at 90 USD/h, free from 3 Nov. Not relocating. Send the Northwind data role."});cotlet call bullhorn add_note --data '{"candidate_id":4821907,"note_action":"Phone Call","comments":"Open to contract at 90 USD/h, free from 3 Nov. Not relocating. Send the Northwind data role."}'Example response
{
"note_id": 6120051,
"candidate_id": 4821907,
"note_action": "Phone Call",
"added_at": "2026-10-23T16:05:00Z"
}