Okapi Okapi

Xero API · Behaviour change

POST /payroll.xro/1.0/PayItems now requires IsQualifyingEarnings

Stopped working

Calls to POST /payroll.xro/1.0/PayItems on Xero API stopped working on September 10, 2026.

What to use instead of these calls

Send IsQualifyingEarnings on every earnings rate in POST /payroll.xro/1.0/PayItems; when true, IsSubjectToSuper must be true (and IsExemptFromSuper false).

Calls it hits

  • POST /payroll.xro/1.0/PayItems

Qualifying Earnings properties on Earnings Rates and Pay Items becoming mandatory 10 September 2026 by Xero Developer Relations The IsQualifyingEarnings property is now required in all create and update requests for AU Earnings Rates and Pay Items.

Xero API, Announcement

Facts

API
Xero API api.xero.com
Kind
Behaviour change
Announced
September 10, 2026
Takes effect
September 10, 2026
Calls after that day
Fail
Source
Announcement
Last updated

More from Xero API

Know before your API calls break.

Okapi finds the calls a breaking change hits in your code and opens the pull request that fixes them.

Add to GitHub