Add candidate note
Adds a note with a Note Action to a candidate's Notes tab.
MCP tool bullhorn_write → add_note
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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bullhorn_write",
"arguments": {
"operation": "add_note",
"arguments": {
"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
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"note_id": 6120051,
"candidate_id": 4821907,
"note_action": "Phone Call",
"added_at": "2026-10-23T16:05:00Z"
},
"isError": false
}