Send job list to candidates
Email a list of jobs to candidates, who can accept or decline each role.
POST https://cotlet.dev/api/v1/vincere/job-list-to-candidates
write Confirm
Sends up to 10 jobs to up to 100 candidates, like Send Job List to Candidates in Vincere. Closed jobs, candidates with a company exclusion notice and candidates already in process for a job are dropped and returned in skipped. Candidates get a branded email and a page where they accept or reject each role, and the Job Consent column tracks it. The email reaches candidates and cannot be recalled. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| job_ids array required | array | Job ids from list_jobs, up to 10. |
| candidate_ids array required | array | Candidate ids from list_candidates, up to 100. |
| message string | string | Personal note added to the email. |
Request
curl -X POST https://cotlet.dev/api/v1/vincere/job-list-to-candidates \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"job_ids":"job ids","candidate_ids":"candidate ids"}'result = client.call("vincere", "send_job_list_to_candidates", {"job_ids":"job ids","candidate_ids":"candidate ids"})const result = await cotlet.call('vincere', 'send_job_list_to_candidates', {"job_ids":"job ids","candidate_ids":"candidate ids"});cotlet call vincere send_job_list_to_candidates --data '{"job_ids":"job ids","candidate_ids":"candidate ids"}'Example response
{
"sent": 2,
"jobs": [
"1042",
"1047"
],
"candidates": [
"88214",
"88251"
],
"skipped": [
{
"candidate_id": "88230",
"reason": "already in the process for job 1047"
}
],
"job_consent": "Pending"
}