Skip to main content

Pre-Built Tooling

CategoryDetails
AuthenticationOAuth 2.0 (Authorization Code with PKCE)
Two-Way SyncYes
Events SupportedYes (via Webhooks)
RealtimeYes (Webhooks)
Supports Rate LimitingYes (60 requests per minute per tenant)
Authentication Scopes Supportedoffline_access, accounting.transactions, accounting.contacts, accounting.settings, and more

Objects Supported

  • Invoices - Sales and purchase invoices
  • Contacts - Customers and suppliers
  • Accounts - Chart of accounts
  • Bank Transactions - Bank statement lines
  • Payments - Payment records
  • Items - Products and services
  • Purchase Orders
  • Credit Notes

Set Up Guide

Trial Access

QuestionAnswer
Offers free trial?Yes. Xero offers a 30-day free trial of accounting software. Start free trial
Requires paid sandboxNo. Demo company included for development.
Requires partnership to obtain authentication?No, but production apps require App Partner approval for public distribution.

Authentication (OAuth 2.0)


Use Cases

1) Invoice automation

Sync invoices between Xero and e-commerce, CRM, or ERP systems for automated billing and payment tracking.

2) Expense management

Connect expense tracking tools with Xero to automatically create purchase invoices and bank transactions from expense reports.

3) Financial reporting

Extract transaction data from Xero for business intelligence, custom dashboards, or consolidated multi-entity reporting.

4) Payment reconciliation

Automatically match incoming payments with invoices and update Xero records when payments are received through payment gateways.

5) Multi-currency operations

Sync international transactions and handle currency conversions across Xero and global payment or banking platforms.

API Gotchas

  • Tenant Selection Required: After OAuth, you must select which Xero organization (tenant) to access. Include xero-tenant-id header in API requests.
  • Rate Limiting: 60 requests per minute per tenant. Exceeding this returns 503 errors. Implement exponential backoff and request queuing.
  • Minimum API Version: Xero requires API version 2.0+ in requests. Always include version in API calls.
  • Four Decimal Places: Xero financial amounts use 4 decimal places. Ensure precision when creating transactions to avoid rounding errors.
For questions or troubleshooting, contact support@runalloy.com.
I