Submit candidates to a job
Submits one or more candidates to a job for the job owner to review.
MCP tool bullhorn_write → add_submission
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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bullhorn_write",
"arguments": {
"operation": "add_submission",
"arguments": {
"job_id": 77314,
"candidate_ids": [
4821907,
4830112
],
"comments": "Both have dbt and Snowflake and can start in November."
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"submissions": [
{
"submission_id": 905601,
"candidate_id": 4821907,
"status": "Submitted"
},
{
"submission_id": 905602,
"candidate_id": 4830112,
"status": "Submitted"
}
]
},
"isError": false
}