Create a Job and Open It

Create a Job and Open It

Resolve org metadata, create a job, set it Open, and verify.

1. List the organization's departments so the job is attached to a real team. Archived departments are excluded so a retired team is not reused.
2. List the organization's locations so the job is attached to a real location, excluding archived ones.
3. List interview plans. A job cannot be moved to Open without a default interview plan, so this must be resolved before the create rather than after it.
4. Create the job against the resolved department, location, and default interview plan. Ashby creates the job in Draft.
5. Transition the job to the requested status. Moving to Open is what makes the job eligible for postings and applications.
6. Read the job back with its location and openings expanded so the caller ends with a confirmed, fully resolved job record.

What you'll need to have ready

• title: The title of the job (e.g. "Software Engineer").
• teamId: The id of the department or team for the job. Resolve this from the listDepartments step output.
• locationId: The id of the job's location. Resolve this from the listLocations step output.
• defaultInterviewPlanId: The id of the default interview plan. Required before the job can be opened; resolve it from the listInterviewPlans step output.
• status: The status to apply to the job (Draft, Open, Closed, Archived).

For your developer

Arazzo workflow ashby-hq:job-create, 6 operations: departmentList → locationlist → interviewPlanList → jobCreate → jobSetStatus → jobInfo. Specs on APIs.io.