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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Additional keys: not allowed |
client_request_id | string | Optional | Echo of the caller-supplied item id. |
errors | array | Optional | Structured item errors using the same public field paths as GET /hire-requirements/. |
errors[] | Model | Each item | Expand Create hire — response body — results results item errors item |
existing_role_id | string | Optional | Matching existing role id for duplicate or rehire conflicts. |
id | string | Optional | Rippling hire role id when a role exists. |
missing_required_fields | array | Optional | Public field paths still required before review. |
missing_required_fields[] | string | Each item | |
next_actions | array | Optional | Actions for duplicate, rehire, or Auto-Hire failures and blockers. |
next_actions[] | Model | Each item | Expand Create hire — response body — results results item next actions item |
pending_fields | array | Optional | Accepted public field paths not yet active because progression is blocked. |
pending_fields[] | string | Each item | |
status | string | Required within parent | ready_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