How-to
Bulk-creating positions
Use the bulk endpoint to create N identical positions in one transaction. Useful for "we need 5 of this role" planning.
Jump to section
When to use
Annual headcount planning, mass-hire scenarios, opening a new team — anywhere you need N identical (or very similar) seats and don't want to click Add Position N times.
The flow
- Organisation > Positions.
- Click Add position > toggle Create multiple.
- Fill in the shared template:
- Title (e.g. "Software Engineer L3")
- Department
- Reports to position
- Salary band
- Budget year
- Set Count — how many to create (e.g. 5).
- Save.
The API creates N rows with identical fields in a single transaction. Each gets a unique ID. They all start with status=open.
After creation
Each position is independent — you can edit, fill, freeze, or close them individually. Common follow-up: open jobs against the first one and let recruitment fill them one-by-one.
Limits
The bulk endpoint accepts up to 20 positions per call. For more, run multiple calls (it's idempotent on (title, department, budget_year) if you re-run).
Naming distinction
After bulk creation, all rows have the same title. If you want them differentiated (e.g. "Engineer 1", "Engineer 2"), edit each row's title — the title is just for display, doesn't affect any logic.