Send candidate email
Email one candidate from their profile, from a template or with your own text.
POST https://cotlet.dev/api/v1/jazzhr/candidates/{candidate_id}/email
write Confirm
Sends from the Emails tab of the candidate's profile, so it is stored there with the rest of the thread. Give either a template or a subject and body. A candidate with no email on file fails and nothing is sent. With send_at the email is scheduled, as JazzHR allows. 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. |
| job_id string | string | Job the email is about. Default: the candidate's most recent job. |
| template string | string | Name of an email template from Settings > Templates > Email. |
| subject string | string | Subject when you write the email yourself instead of using a template. |
| body string | string | Message text when you write the email yourself. |
| send_at datetime | datetime | Send later at this time. Default: now. |
Request
curl -X POST https://cotlet.dev/api/v1/jazzhr/candidates/candidate_8c41d2/email \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("jazzhr", "send_candidate_email", {"candidate_id":"candidate_8c41d2"})const result = await cotlet.call('jazzhr', 'send_candidate_email', {"candidate_id":"candidate_8c41d2"});cotlet call jazzhr send_candidate_email --data '{"candidate_id":"candidate_8c41d2"}'Example response
{
"candidate_id": "prospect_20261016_77ad",
"template": "Decline after interview",
"sent_to": "luis.ortega@example.com",
"status": "sent"
}