Submit candidates to a job
Submits one or more candidates to a job for the job owner to review.
POST https://cotlet.dev/api/v1/bullhorn/jobs/{job_id}/submissions
write Confirm
Creates an internal submission per candidate, as Actions > Add Submission does on the job record. Bullhorn sets the status to Submitted and the submission goes to the job owner. Submitting several candidates at once works only if your company's policies allow it. Returns one submission_id per candidate. 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 from get_job or the job record URL. |
| candidate_ids integer[] required | integer[] | Candidates to submit. |
| comments string | string | Comment shown with the submission. |
Request
curl -X POST https://cotlet.dev/api/v1/bullhorn/jobs/77314/submissions \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"candidate_ids":[4821907,4830112],"comments":"Both have dbt and Snowflake and can start in November."}'result = client.call("bullhorn", "add_submission", {"job_id":77314,"candidate_ids":[4821907,4830112],"comments":"Both have dbt and Snowflake and can start in November."})const result = await cotlet.call('bullhorn', 'add_submission', {"job_id":77314,"candidate_ids":[4821907,4830112],"comments":"Both have dbt and Snowflake and can start in November."});cotlet call bullhorn add_submission --data '{"job_id":77314,"candidate_ids":[4821907,4830112],"comments":"Both have dbt and Snowflake and can start in November."}'Example response
{
"submissions": [
{
"submission_id": 905601,
"candidate_id": 4821907,
"status": "Submitted"
},
{
"submission_id": 905602,
"candidate_id": 4830112,
"status": "Submitted"
}
]
}