Email candidates from a job
Send one email to several candidates of a job, each as an individual message.
POST https://cotlet.dev/api/v1/loxo/jobs/{job_id}/emails
write Confirm
Sends from the job pipeline, as the Email button does, so each email is linked to the job. Loxo sends every recipient an individual message, so they do not see each other. A person with no address of that type is skipped and listed in the response. It sends text only: no merge tags, attachments or SMS. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id integer required | integer | Job id, so Loxo links the email to the job. |
| person_ids array required | array | Person ids of the recipients. |
| subject string required | string | Subject line. |
| body string required | string | Plain-text message, sent as written to every recipient. |
| email_type string | string | Email type to send to, for example Personal or Work. Default: the primary email, the first listed on the record. |
Request
curl -X POST https://cotlet.dev/api/v1/loxo/jobs/2481530/emails \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"person_ids":[48211077,48211102,48211130],"subject":"Senior Data Engineer: client call moved to Thursday","body":"Hi, the client call has moved to Thursday at 3 pm. Please reply to confirm you can make it."}'result = client.call("loxo", "send_email", {"job_id":2481530,"person_ids":[48211077,48211102,48211130],"subject":"Senior Data Engineer: client call moved to Thursday","body":"Hi, the client call has moved to Thursday at 3 pm. Please reply to confirm you can make it."})const result = await cotlet.call('loxo', 'send_email', {"job_id":2481530,"person_ids":[48211077,48211102,48211130],"subject":"Senior Data Engineer: client call moved to Thursday","body":"Hi, the client call has moved to Thursday at 3 pm. Please reply to confirm you can make it."});cotlet call loxo send_email --data '{"job_id":2481530,"person_ids":[48211077,48211102,48211130],"subject":"Senior Data Engineer: client call moved to Thursday","body":"Hi, the client call has moved to Thursday at 3 pm. Please reply to confirm you can make it."}'Example response
{
"job_id": 2481530,
"sent": 3,
"email_type": "Primary",
"recipients": [
{
"person_id": 48211077,
"name": "Priya Nair",
"status": "sent"
},
{
"person_id": 48211102,
"name": "Tom Becker",
"status": "sent"
},
{
"person_id": 48211130,
"name": "Lena Ortiz",
"status": "sent"
}
],
"skipped": []
}