Submit pay data for an off-cycle (supplemental/bonus) payroll run in ADP Workforce Now using the Payroll Data Input API.

Steps

1. Have a payroll practitioner open/create the off-cycle payroll cycle in ADP Workforce Now (via the off-cycle/adjustment payroll option) so its cycle status becomes 'Entering Payroll Information' — the API cannot create or initiate the off-cycle cycle itself.
2. Call GET /events/payroll/v1/pay-data-input.modify/meta (optionally filtered by companyCode and fileNumber) to retrieve the valid earning codes, deduction codes, and other codelists configured for the company, including the bonus/supplemental earning code.
3. Build a payload with eventContext (company/payroll group code, batch/process job ID) and payDataInput/payeePayInputs entries that use the bonus/supplemental earning code and a distinct payNumber to represent the off-cycle check.
4. POST the payload to /events/payroll/v1/pay-data-input.modify and confirm a 200 response.
5. On 400 errors, validate the payrollGroupCode, employee file number, and earning/deduction codes against the meta response before retrying — common causes are an invalid company/payroll group code or a code not present in the Validation Table.
6. Have the payroll practitioner review the imported entries on the Paydata page in ADP Workforce Now and process/finalize the off-cycle run manually — the API only populates pay data, it does not submit or finalize the payroll run.