Actions57
- Appointment Actions
- Candidate Actions
- Client Contact Actions
- Client Corporation Actions
- Job Order Actions
- Job Submission Actions
- Lead Actions
- Note Actions
- Opportunity Actions
- Placement Actions
- Task Actions
Job Submission → Create
AI-generatedSummary
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.'