Xero API
POST /payroll.xro/1.0/PayItems now requires IsQualifyingEarnings
Stopped workingSubscribe to Xero APIShare
On September 10, 2026, the IsQualifyingEarnings property became mandatory for create and update requests for AU Earnings Rates and Pay Items. Calls to POST /payroll.xro/1.0/PayItems fail if this field is missing.
Calls it hits
POST /payroll.xro/1.0/PayItems
What to use instead of these calls
Send IsQualifyingEarnings on every earnings rate in POST /payroll.xro/1.0/PayItems. When set to true, IsSubjectToSuper must be true and IsExemptFromSuper must be false.
In Xero API's words
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.
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
- Verified
- , against Xero API's own pages
Questions
When does this change take effect?
Calls to POST /payroll.xro/1.0/PayItems on Xero API stopped working on September 10, 2026.
What happens to calls after September 10, 2026?
They have failed since September 10, 2026.
How do I find the calls this hits in my code?
Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.
More from Xero API 8
-
GET /finance.xro/1.0/AccountingActivities/*Removal Stopped working -
/practicemanager/3.1/lead.api/*Removal Stopped working -
/practicemanager/3.0/purchaseorder.api/*Removal Stopped working -
/practicemanager/3.1/supplier.api/*Removal Stopped working -
POST /payroll.xro/2.0/employees/{id}/taxBehaviour change Stops workingin 27 days -
/api.xro/2.0/ExpenseClaims*Endpoint removal Stops workingin 87 days -
/practicemanager/3.0/*Version retirement Stops workingin 181 days -
No date
/api.xro/2.0/Receipts*Endpoint removal Deprecated, no date
You fixed this one by hand.
Okapi opens the pull request with the fix before the next breaking change reaches your code.