Team Calendar

Integrations

Xero Payroll integration

Team Calendar is built exclusively for Xero Payroll. It connects via OAuth, syncs leave data continuously, and writes approved leave submissions back to Xero. Xero remains your payroll source of truth.

Supported payroll regions

Team Calendar supports Xero Payroll in three regions. Each region has its own leave type configuration, and Team Calendar handles each correctly.

AU

Australia

Supports Xero Payroll Australia leave types including annual leave, sick leave, long service leave, personal carer's leave, and public holidays.

NZ

New Zealand

Supports Xero Payroll New Zealand leave types including annual leave, sick leave, alternative leave, bereavement leave, and statutory holidays.

UK

United Kingdom

Supports Xero Payroll United Kingdom leave types including annual leave, sick leave, maternity and paternity leave, and statutory leave entitlements.

What Team Calendar reads and writes

Team Calendar accesses only payroll data relevant to leave and availability. It does not read salary, banking, tax, or superannuation data.

Reads from Xero

  • Employee records (name, employment status, start date)
  • Leave entitlements and leave type configuration
  • Approved leave applications and balances
  • Payroll calendar and pay period information

Writes to Xero

  • Leave applications submitted via Team Calendar
  • Manager approval and decline decisions
  • Leave application status updates

How the connection works

The Xero OAuth flow is standard and takes a few minutes. You authorise Team Calendar directly from your Xero account, no third-party credentials required.

1

Connect your organisation

In Team Calendar, navigate to Settings and select Connect Xero. You will be redirected to Xero to authorise access.

2

Authorise in Xero

Log in to Xero if prompted, select the payroll file you want to connect, and approve the permission request. Team Calendar requests read and write access to payroll data only.

3

Select your payroll file

If your Xero account contains multiple payroll files, select the one to associate with this Team Calendar organisation. One payroll file per organisation.

4

First sync runs automatically

Team Calendar immediately syncs employees and leave data. Depending on the size of your payroll file, the first sync takes between 30 seconds and a few minutes.

Sync model explained

Team Calendar runs scheduled syncs to keep availability data current. Here is how data flows between systems.

Employee sync

Xero employee records are synced into Team Calendar. When a new employee is added in Xero, they appear in Team Calendar after the next sync. Terminated employees are archived automatically.

Leave sync

Approved leave from Xero is continuously synced. Leave data is normalised into a canonical availability model. The raw Xero payload is retained for audit purposes.

Write-back

When a manager approves or declines a leave request in Team Calendar, the decision is written back to Xero synchronously. There is no batch process or delay.

Security and token handling

Xero OAuth tokens are encrypted at rest using industry-standard encryption. Tokens are never exposed to client-side code or stored in plaintext. Team Calendar rotates tokens proactively before expiry. If you revoke access in Xero, the connection is deactivated immediately on the next sync attempt.