The Connect button is greyed out
Xero isn’t switched on for this PeopleTeam installation yet. Contact PeopleTeam support.
“This organisation doesn’t have Payroll AU”
You chose a Xero organisation without Australian payroll. Disconnect, then connect again and choose the organisation that runs your payroll.
I chose the wrong organisation
Click Disconnect, then Connect Xero again. You may need to sign out of Xero first to see the organisation picker.
“Access was declined” or permissions are missing
The person who signed in to Xero didn’t approve all the permissions, or isn’t a payroll admin. Ask a Xero payroll admin to connect.
The connection expired
Xero ends connections that aren’t used for 60 days, or when they’re removed in Xero under Connected apps. Click Reconnect on the Xero card.
Someone was added directly in Xero
They won’t be linked to anyone in PeopleTeam. Re-run the setup review and match them in the People step.
A sync item failed
Open Payroll → Xero sync. Each failed item shows the reason and a Retry button. Common causes are a closed pay period or a missing leave type link.
Depends on your plan
Xero sync is included in the Plus and Full Platform plans. If your organisation's plan doesn't include it, the hourly sync skips your organisation and Admin → Integrations isn't available. Your saved Xero data is kept.