{"id":"b92eb889-34df-49fc-a6ac-e2d41855d1c4","task":"Submit pay data for an off-cycle (supplemental/bonus) payroll run in ADP Workforce Now using the Payroll Data Input API.","domain":"developers.adp.com","steps":["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.","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.","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.","POST the payload to /events/payroll/v1/pay-data-input.modify and confirm a 200 response.","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.","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."],"gotchas":["The API call is rejected unless the target payroll cycle's status is exactly 'Entering Payroll Information' or 'Correcting Input' — you must open/prepare the off-cycle cycle in the UI first; the API cannot start an off-cycle run on its own.","Bonus/supplemental earnings are commonly subject to a flat supplemental withholding rate (ADP cites 22% in its own off-cycle payroll guidance) rather than regular withholding tables; this is applied by ADP's payroll engine based on which earning code you use, so using the wrong code produces incorrect withholding.","There is no public 'finalize/submit payroll' API — after the pay data batch is posted, a human payroll practitioner must still review and process the off-cycle run inside ADP Workforce Now."],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/b92eb889-34df-49fc-a6ac-e2d41855d1c4"}