Rippling: Create a new job requisition — request body — body

API reference · Contract 2026-10-28

SDK schema: Create a new job requisition — request body — body

Field	Type	Presence	Description and constraints
$	object	Root	DTO for creating JobRequisitions via the Platform API. Maps to the existing ATS JobRequisitionDTO for use with create_from_DTO service.
confidential	boolean	Optional	Whether this requisition is confidential
confidential_whitelist	array	Optional	List of role IDs allowed to view confidential requisition
confidential_whitelist[]	string	Each item
coordinator_id	string	Optional	Coordinator role ID
default_private_invites	boolean	Optional	Whether to default to private invites
departments	array	Optional	List of department IDs
departments[]	string	Each item
description	string	Optional	Job description
employment_type_id	string	Optional	Company employment type ID
hiring_manager_id	string	Optional	Hiring manager role ID
is_evergreen	boolean	Optional	Whether this is an evergreen requisition
levels	array	Optional	List of level IDs
levels[]	string	Each item
name	string	Required within parent	Title/name of the job requisition
pipeline_plan_id	string	Optional	Pipeline plan ID to use for this requisition
recruiter_id	string	Optional	Primary recruiter role ID
requisition_id	string	Optional	Customer-defined requisition ID. Auto-generated if not provided.
salary_currency	string	Optional	Salary currency code
salary_per_unit	number	Optional	Salary amount per unit
salary_per_unit_high	number	Optional	Salary range upper bound
salary_per_unit_low	number	Optional	Salary range lower bound
salary_type	string	Optional	Salary type
salary_unit	string	Optional	Salary unit (HOUR, DAY, WEEK, MONTH, YEAR, PAY_PERIOD)
secondary_recruiters	array	Optional	List of secondary recruiter role IDs
secondary_recruiters[]	string	Each item
sourcer_id	string	Optional	Sourcer role ID
status	string	Optional	Job requisition status (e.g., DRAFT, OPEN, CLOSED)
target_close	string	Optional	Target close date
target_employee_start_date	string	Optional	Target employee start date
teams	array	Optional	List of team IDs
teams[]	string	Each item
title	string	Optional	Internal employee title
work_locations	array	Optional	List of work location IDs
work_locations[]	string	Each item