# POST /payroll.xro/2.0/employees/{EmployeeID}/tax now requires KiwiSaverStatus

Calls to POST /payroll.xro/2.0/employees/{id}/tax, body parameter KiwiSaverStatus on Xero API stop working on December 3, 2026.

Starting December 3, 2026, requests to POST /payroll.xro/2.0/employees/{id}/tax will fail if they omit the body parameter KiwiSaverStatus for affected tax codes. Calls lacking this parameter will return a 400 Bad Request error.

## What to use instead

Update your integration to explicitly send KiwiSaverStatus for every affected tax code.

- API: Xero API (api.xero.com)
- Kind: Behaviour change
- Announced: August 6, 2026
- Takes effect: December 3, 2026
- Calls after that day: fail
- Calls it hits: `POST /payroll.xro/2.0/employees/{id}/tax`, `body parameter KiwiSaverStatus`
- Source: [Changelog](https://developer.xero.com/changelog)
- Verified: November 6, 2026, against Xero API's own pages
- Page: https://www.okapi.bot/providers/xero-api/breaking-changes/post-payroll-xro-2-0-employees-employeeid-tax-now-requires-kiwisaverstatus/

## Xero API's words

> Requests to POST/payroll.xro/2.0/employees/{EmployeeID}/tax that omit KiwiSaverStatus for affected tax codes will return a 400 Bad Request.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent