Skip to content

Rippling: Create a new off-cycle payroll run — response body — runs item

Create a new off-cycle payroll run: response body, field runs / item. Complete fields and constraints for contract 2026-10-28.

API reference · Contract 2026-10-28

SDK schema: Create a new off-cycle payroll run — response body — runs item

FieldTypePresenceDescription and constraints
$objectRoot
check_datestringRequired within parentPayment date selected for this run.
company_entity_idJSONRequired within parent
company_entity_id (anyOf 1)stringAlternativeHRIS company entity relationship ID for this run, matching company_entity_id on payroll run retrieval. Null if the relationship cannot be resolved.
company_entity_id (anyOf 2)nullAlternative
country_codestringRequired within parentCountry code of the payroll entity.
employment_splitstringRequired within parentWorker eligibility category used to split this run, such as employees or contractors.
pay_periodobjectRequired within parentPay period for this run.
pay_period.end_datestringRequired within parentEnd date of this run’s pay period.
pay_period.start_datestringRequired within parentStart date of this run’s pay period.
run_configurationobjectRequired within parentCalculation configuration used for this run.
run_configuration.pay_basisstringRequired within parentAmount basis used by the created run. This API currently creates gross-pay runs.
run_idstringRequired within parentIdentifier of the created draft payroll run.
run_statusstringRequired within parentStatus of the created payroll run.
run_typestringRequired within parentType of the created payroll run.
worker_idsarrayRequired within parentRole IDs included in this run.
worker_ids[]stringEach 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.