Skip to content

Rippling: Create hire — response body — results results item

Create hire: response body, field results / results / item. Complete fields and constraints for contract 2026-10-28.

API reference · Contract 2026-10-28

SDK schema: Create hire — response body — results results item

FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
client_request_idstringOptionalEcho of the caller-supplied item id.
errorsarrayOptionalStructured item errors using the same public field paths as GET /hire-requirements/.
errors[]ModelEach itemExpand Create hire — response body — results results item errors item
existing_role_idstringOptionalMatching existing role id for duplicate or rehire conflicts.
idstringOptionalRippling hire role id when a role exists.
missing_required_fieldsarrayOptionalPublic field paths still required before review.
missing_required_fields[]stringEach item
next_actionsarrayOptionalActions for duplicate, rehire, or Auto-Hire failures and blockers.
next_actions[]ModelEach itemExpand Create hire — response body — results results item next actions item
pending_fieldsarrayOptionalAccepted public field paths not yet active because progression is blocked.
pending_fields[]stringEach item
statusstringRequired within parentready_for_review, auto_hire_processing, incomplete, or failed. auto_hire_processing includes hires awaiting approval or asynchronous completion.

Referenced models: Create hire — response body — results results item errors item, Create hire — response body — results results item next actions item

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.