Create task
Create a task on a candidate for a teammate, with a due date and optional email notice.
MCP tool jazzhr_write → create_task
write Confirm
Creates the task the way the profile's All Tasks section does. assign_to must match one user, and no match fails with the list of names. With notify_by_email the assignee gets an email with a Go to Candidate button. 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 list_candidates. |
| title string required | string | Task title. |
| assign_to string required | string | Name of a JazzHR user on your account. |
| due_date date | date | Due date. Default: none. |
| notes string | string | Task notes. |
| notify_by_email boolean | boolean | Email the assignee, as the Notify by email option does. Default: false. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "jazzhr_write",
"arguments": {
"operation": "create_task",
"arguments": {
"candidate_id": "prospect_20261016_77ad",
"title": "Send interview feedback",
"assign_to": "Maria Costa",
"due_date": "2026-10-22",
"notify_by_email": true
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"task_id": "task_20261020_c17",
"candidate_id": "prospect_20261016_77ad",
"title": "Send interview feedback",
"assigned_to": "Maria Costa",
"due_date": "2026-10-22",
"notified": true
},
"isError": false
}