Xero / Finance

Xero POST Invoices/{InvoiceID}/Email breaking change date

POST Invoices/{InvoiceID}/Email returns 429 instead of 500 when the daily invoice email limit is reached, with no Retry-After header.

88days left
Change
Breaking change
Effective
Jan 14, 2027
Replacement
Handle HTTP 429 Too Many Requests as a retriable condition instead of a 500 error
Source
developer.xero.com
Vendor's words
Upcoming breaking change: When an organisation reaches its daily limit for sending invoice emails, POST Invoices/{InvoiceID}/Email will return a 429 Too Many Requests response instead of a generic 500 Internal Server Error. No Retry-After header is included. What you need to do: Handle 429 on this endpoint as a temporary, retriable condition, not a failure. The limit is daily, so don't retry immediately, queue the se…

Add Xero dates to calendar Report a correction

Don't get surprised again

Get the weekly →One email every Friday: what's dying this week and what's newly announced.