Skip to content

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

Create hire: request body, field body / hires / item / employment / notice. 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 notice

FieldTypePresenceDescription and constraints
$objectRootNotice-period arrangement for ending employment: standard or a custom period.
Additional keys: not allowed
quantityintegerOptionalNumber of notice-period units. Required for CUSTOM_NOTICE; omit for STANDARD_NOTICE.
typestringRequired within parentNotice-period arrangement for ending employment. STANDARD_NOTICE applies the standard period; CUSTOM_NOTICE supplies a specific period.
One of: STANDARD_NOTICE, CUSTOM_NOTICE
unitstringOptionalUnit for the custom notice period: DAYS, WEEKS, MONTHS, or YEARS. Required for CUSTOM_NOTICE; omit for STANDARD_NOTICE.
One of: DAYS, WEEKS, MONTHS, YEARS

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.