Send email to candidate
Send an email to a candidate from a template or your own text, now or at a set time.
MCP tool ashby_write → send_email
write Confirm
Sends an email to the candidate from the Ashby profile, so it appears in the candidate's email history. Give either a template name or a subject and body; substitution tokens in a template are filled by Ashby. Scheduled emails can be viewed and rescheduled only by the person who drafted them, which is your connected account. 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 search_candidates. |
| template string | string | Template name from list_email_templates. Or set subject and body. |
| subject string | string | Subject, when no template is used. |
| body string | string | Email body, when no template is used. |
| send string | string | 'immediately' or 'scheduled'. Default: immediately. With 'scheduled', set send_at. |
| send_at string | string | ISO 8601 date and time with offset, only with send set to scheduled. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ashby_write",
"arguments": {
"operation": "send_email",
"arguments": {
"candidate_id": "candidate_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"email_id": "a09d3e72-5b16-4c84-97f0-e2c48b1d6a35",
"candidate_id": "e1f7a309-4c52-4d8b-a063-9b25d7c1e840",
"subject": "Still interested?",
"status": "sent",
"sent_at": "2026-10-16T09:00:00+02:00"
},
"isError": false
}