Pass correction to create a replacement external payroll and attach it to a draft correction in the same request. This is the historical-payroll counterpart to Create a payroll with correction — use it when the replacement should be recorded as pay history outside the managed payroll flow.

Replacement external payrolls

When correction is supplied:

• The company must have run a managed payroll.
• payday must be in the past, before the company's start_date, and within the correction's tax year.
• The correction must be in draft, belong to the same company, and accept replacement payrolls.
• The caller must have correction:write or correction:admin scope.

Supplying correction also allows creating an external payroll replacement for a company that otherwise could not use the external payroll API for that tax year.

External payroll responses include correction as the ID of the correction this payroll is an operation of, or null. On update, correction may be included only to restate the payroll's current correction ID; a different value is rejected.

External payrolls attached to a correction reject Validate an external payroll, Approve an external payroll, Reopen an external payroll, and Preview an external payroll with error type payroll_managed_by_correction.

See Correcting Pay History for the full void-and-replace workflow.