Xero Accounting API

Xero is a cloud accounting platform for small and medium businesses. Its API provides programmatic access to invoices, contacts, bank transactions, expenses, payroll, fixed assets, and financial reports, enabling accounting automation and integrations.

Evaluated Mar 06, 2026 (0d ago) vcurrent
Homepage ↗ Repo ↗ Finance xero accounting invoicing payroll rest-api oauth2 sdk small-business bookkeeping
⚙ Agent Friendliness
68
/ 100
Can an agent use this?
🔒 Security
87
/ 100
Is it safe for agents?
⚡ Reliability
84
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
--
Documentation
82
Error Messages
75
Auth Simplicity
72
Rate Limits
75

🔒 Security

TLS Enforcement
100
Auth Strength
85
Scope Granularity
85
Dep. Hygiene
82
Secret Handling
82

OAuth2 with organization-specific scopes. SOC2 Type II, ISO27001. Financial data — extremely sensitive. Connection authorized per organization. 30-minute access tokens with refresh tokens.

⚡ Reliability

Uptime/SLA
90
Version Stability
85
Breaking Changes
80
Error Recovery
82
AF Security Reliability

Best When

An agent needs to manage accounting data, generate invoices, or reconcile transactions for a small or medium business already using Xero.

Avoid When

The business uses QuickBooks, Sage, or other accounting software — data migration adds significant friction.

Use Cases

  • Automated invoice creation and payment tracking
  • Bank reconciliation automation
  • Expense claim processing and approval workflows
  • Financial report generation (P&L, balance sheet)
  • Contact and supplier management
  • Multi-currency accounting and FX reconciliation

Not For

  • Large enterprise ERP needs (Xero targets SMBs; lacks some enterprise features)
  • US payroll (Xero Payroll is limited to certain regions)
  • Real-time payment processing (use Stripe or similar for payments)

Interface

REST API
Yes
GraphQL
No
gRPC
No
MCP Server
No
SDK
Yes
Webhooks
Yes

Authentication

Methods: oauth2
OAuth: Yes Scopes: Yes

OAuth2 with PKCE for user authorization. Scopes are granular per resource area (accounting.transactions, accounting.contacts, payroll.employees, etc.). Tokens expire after 30 minutes; refresh tokens valid for 60 days. Multi-tenant support — one app can connect to multiple Xero organisations, each with its own tenantId that must be passed on every API call.

Pricing

Model: subscription
Free tier: No
Requires CC: Yes

30-day free trial available. App connections require the merchant to have an active Xero subscription. Partner apps can be built for free but require merchant subscription for production use.

Agent Metadata

Pagination
page
Idempotent
No
Retry Guidance
Documented

Known Gotchas

  • tenantId must be passed on every API call — missing this is the most common agent error
  • Access tokens expire after 30 minutes — agents must implement token refresh proactively
  • 60 calls/minute per organisation limit is easy to hit when syncing large datasets
  • Modified-since filtering is critical for incremental sync — otherwise agents re-fetch all data
  • Xero uses GUID-based IDs everywhere — agents must resolve names to GUIDs before referencing
  • Multi-tenant apps must store and manage tenantId separately from the OAuth token
  • Some fields are region-specific (TaxType values vary by country) — hardcoding values causes cross-region failures
  • Webhook verification requires HMAC-SHA256 signature checking; event delivery is not guaranteed exactly-once

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for Xero Accounting API.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-06.

5388
Packages Evaluated
26151
Need Evaluation
173
Need Re-evaluation
Community Powered