Rippling: Create hire — request body — body hires item employment contract

Create hire: request body, field body / hires / item / employment / contract. Complete fields and constraints for contract 2026-10-28.

API reference · Contract 2026-10-28

SDK schema: Create hire — request body — body hires item employment contract

Field	Type	Presence	Description and constraints
`$`	object	Root	Employment term: ongoing with no predetermined end or fixed for a defined term. Additional keys: not allowed
`duration`	object	Optional	Exact fixed-term length. Use only with type FIXED; omit for INDEFINITE. Additional keys: not allowed
`duration.unit`	string	Required within parent	Duration unit: DAYS, WEEKS, MONTHS, or YEARS. One of: DAYS, WEEKS, MONTHS, YEARS
`duration.value`	integer	Required within parent	Positive number of duration units.
`minimum_guaranteed_duration`	object	Optional	Minimum contract length guaranteed to the worker, distinct from the exact total duration. Additional keys: not allowed
`minimum_guaranteed_duration.unit`	string	Required within parent	Duration unit: DAYS, WEEKS, MONTHS, or YEARS. One of: DAYS, WEEKS, MONTHS, YEARS
`minimum_guaranteed_duration.value`	integer	Required within parent	Positive number of duration units.
`mission`	Model	Optional	Expand Create hire — request body — body hires item employment contract mission
`type`	string	Required within parent	Whether employment is ongoing or fixed-term. Use INDEFINITE when there is no predetermined end and FIXED when the employment is limited to a defined term. One of: FIXED, INDEFINITE