Create an Opening and Bind It to a Job
A 5-step recipe with Ashby. We can help you get access.
Recipe · 5 steps
Create an Opening and Bind It to a Job
with Ashby · Talent Acquisition Management
Create an opening, bind a job and location to it, open it, and verify.
- Create the opening with its headcount metadata. jobIds and locationIds are deliberately left off here so the attach steps below exercise the same calls a sync would use against an opening that already exists.
- Attach the job to the opening, which is what ties the hiring process to the approved seat.
- Attach the location to the opening so headcount is reported against the right site.
- Move the opening to the requested state. Closing an opening additionally requires a close reason, which can be resolved from closeReason.list.
- Read the assembled opening back to confirm the job, location, and state all landed on one record.
What you'll need to have ready
- identifier: The human-readable identifier for the opening (e.g. "ENG-104").
- description: A description of the opening.
- teamId: The id of the department or team the opening belongs to.
- jobId: The id of the job to attach to the opening.
- locationId: The id of the location to attach to the opening.
- targetHireDate: The target hire date for the opening.
- targetStartDate: The target start date for the opening.
- isBackfill: Whether this opening backfills a departing employee.
- employmentType: The employment type for the opening.
- openingState: The state to move the opening to (e.g. Open).
For your developer
Arazzo workflow ashby-hq:opening-setup, 5 operations: openingcreate → openingaddjob → openingaddlocation → openingsetopeningstate → openinginfo. Specs on APIs.io.