Bullhorn icon

Bullhorn

Interact with Bullhorn CRM API

Job Submission → Create

AI-generated

Summary

Creates a new job submission linking a candidate to a job order in Bullhorn, or updates/restores an existing submission if one already exists for the candidate and job order.

Inputs

  • candidate (required) — The ID of the candidate to submit for the job order.
  • jobOrder (required) — The ID of the job order the candidate is being submitted to.
  • status (required) — Initial status of the submission (defaults to 'New Lead').
  • additionalFields — Optional fields to include in the submission, such as comments, source, sending user ID, date web response, or custom fields JSON.
  • customFieldValues — Set labeled custom fields on the submission dynamically.

Output shape

a single record

Returns Bullhorn's API response object containing details about the created, updated, or restored Job Submission entity (e.g. changedEntityId and changeType). If an active or soft-deleted submission already exists for the candidate and job order combination, the operation updates or restores that record to prevent unique association conflict errors.

Examples

Example 1: Submit a newly screened candidate to an open job order

Candidate ID: 12345, Job Order ID: 6789, Status: 'Submitted', Additional Fields -> Comments: 'Candidate meets all technical requirements.'

Links

Discussion