Add candidate note
A note on a candidate record, with an action type and an optional job link.
MCP tool jobdiva_write → add_candidate_note
write
Saves the note on the record and returns its note_id. The action is the type name as set up in your JobDiva account; copy one from list_candidate_notes. job_id links the note to an open job. It sends nothing and reaches no one, so it does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id integer required | integer | Candidate ID from search_candidates or find_candidate. |
| note string required | string | Text of the note. |
| action string | string | Action type name as set up in your JobDiva account, for example Phone Call. |
| job_id integer | integer | Open job the note is about. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "jobdiva_write",
"arguments": {
"operation": "add_candidate_note",
"arguments": {
"candidate_id": 5821904,
"note": "Open to contract at 90 USD/h, free from 3 Nov. Not relocating.",
"action": "Phone Call",
"job_id": 24071835
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"note_id": 90214531,
"candidate_id": 5821904,
"action": "Phone Call",
"job_id": 24071835,
"status": "saved"
},
"isError": false
}