--- title: Xero API Integration on Truto slug: xero category: Accounting canonical: "https://truto.one/integrations/detail/xero/" --- # Xero API Integration on Truto **Category:** Accounting **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Users** — The User object represents a User. ### Unified Accounting API - **Accounts** — Account represents bank accounts or a general ledger account - **Attachments** — Attachment represents the company's attachment - **Budgets** — Budget represents the budgets set for a company - **Company Info** — Company Info represents the company's information - **Contact Groups** — ContactGroup represents the groupings used by the company for their contacts - **Contacts** — Contacts represents the company's vendor or a customer - **Credit Notes** — Credit Notes represents the credit notes of the company - **Currencies** — Currency represents the currencies used by the company - **Employees** — Employee represents an employee of the company - **Invoices** — Invoices represents the invoices of the company - **Items** — Items represents the items of the company - **Journal Entries** — Journal Entries represents the journal entries of the company - **Payments** — Payments represents the payments of the company - **Purchase Orders** — Purchase Orders represents the purchase orders of the company - **Repeating Transactions** — RepeatingTransaction represents the repeating transactions of the company - **Reports** — Report gets you the various reports available in the accounting software - **Tax Rates** — TaxRates represents the tax rates of the company - **Tracking Categories** — TrackingCategories represents the tracking categories of the company - **Transactions** — Transactions represents the transactions of the company ## How it works 1. **Link your customer's Xero account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Xero.** The Proxy API is a 1-to-1 mapping of the Xero API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Automate invoice creation from your SaaS into Xero** — If your platform handles billing, project completion, or service delivery, you can automatically push invoices into your users' Xero accounts — eliminating dual data entry and keeping their accounts receivable current in real time. - **Pull financial data for underwriting and credit decisioning** — Lending, financing, and fintech platforms can read their users' Xero reports, transactions, and account balances to algorithmically assess business health — replacing manual CSV and PDF uploads with a live, authenticated data connection. - **Sync expenses and receipts into the general ledger** — Spend management and corporate card platforms can push categorized transactions into Xero with receipt attachments, mapped to the correct chart of accounts and tracking categories, so month-end close is effortless for the user's accountant. - **Keep CRM contacts and payment status in sync with Xero** — CRM and sales platforms can sync contacts bidirectionally and surface outstanding invoice and payment data from Xero directly inside the sales workflow, giving reps real-time visibility into customer financial status. - **Manage subscription revenue recognition in Xero** — Billing and subscription platforms can generate invoices, credit notes, and payments in Xero whenever subscriptions change — ensuring the general ledger accurately mirrors the subscription engine across currencies and tax jurisdictions. ## What you can build - **Chart of Accounts Mapping UI** — Let your users map your product's categories to their specific Xero accounts, tax rates, and tracking categories before any data is synced, ensuring every transaction lands in the right place on the ledger. - **Automated Invoice and Payment Sync** — Push invoices into Xero when work is completed or deals close, and automatically reconcile them by creating payments when funds are collected through your platform. - **Real-Time Financial Health Dashboard** — Pull P&L statements, balance sheets, and company info from Xero to populate analytics dashboards or feed proprietary scoring models inside your product. - **Receipt Attachment Pipeline** — Attach receipt images and supporting documents directly to Xero transactions and invoices via the Attachments resource, making audit prep seamless for your users' accountants. - **Bi-Directional Contact and Vendor Sync** — Sync customers and vendors between your platform and Xero using Contacts and Contact Groups, keeping records consistent across systems without manual reconciliation. - **Daily Sales Journal Entry Aggregation** — Aggregate POS or e-commerce transactions into summarized journal entries in Xero — avoiding thousands of individual line items while maintaining accurate revenue and tax reporting. ## FAQs ### What authentication method does Xero use? Xero uses OAuth 2.0 for authentication. Truto handles the full OAuth flow — including token refresh — so your team doesn't need to manage auth lifecycle or deal with token expiry for your end users' connections. ### Which Xero data models can I access through Truto's Unified Accounting API? Truto's Unified Accounting API supports Accounts, Attachments, Budgets, Company Info, Contact Groups, Contacts, Credit Notes, Currencies, Employees, Invoices, Items, Journal Entries, Payments, Purchase Orders, Repeating Transactions, Reports, Tax Rates, Tracking Categories, and Transactions. A Unified User Directory API is also available for Users. ### Can I both read and write data to Xero through Truto? Yes. The Unified Accounting API supports both read and write operations across supported resources — for example, you can create invoices, push payments, and attach receipts, as well as read reports and transaction history. ### Does Truto handle Xero's API rate limits and pagination? Yes. Truto abstracts away Xero's rate limiting and pagination logic. You query Truto's unified endpoints, and Truto manages retries, backoff, and cursor-based pagination under the hood so you don't have to build that plumbing yourself. ### Can I access Xero's Tracking Categories for department or location-level reporting? Yes. Tracking Categories are a supported resource in the Unified Accounting API. You can read your users' configured tracking categories and options, then apply them when creating invoices, journal entries, or transactions to ensure data is tagged by department, location, or any custom dimension the user has set up in Xero. ### Does the integration support multi-currency Xero organizations? Yes. The Currencies resource is available through the Unified Accounting API, allowing you to read which currencies are enabled in your user's Xero organization and reference them when creating invoices, payments, or other financial records. ## Related reading - [How to Integrate the Brex API with Xero and QuickBooks (2026 Developer Guide)](https://truto.one/blog/developer-tutorial-how-to-integrate-brex-with-xero-and-quickbooks/) — A complete engineering guide to syncing Brex transactions into QuickBooks Online and Xero. Learn how to handle strict API rate limits, double-entry ledger mapping, and unified API architecture. - [How to Integrate with the Xero API: A Guide for B2B SaaS](https://truto.one/blog/how-do-i-integrate-with-the-xero-api-a-guide-for-b2b-saas/) — A technical guide to building a production-grade Xero API integration, covering OAuth 2.0 token management, rate limits, webhook validation, and the 2026 pricing shift. - [How to Connect AI Agents to Xero and QuickBooks: MCP Server Architecture Guide](https://truto.one/blog/how-to-connect-ai-agents-to-xero-and-quickbooks-mcp-server-architecture-guide/) — Learn how to connect AI agents to Xero, QuickBooks, and Brex using an MCP server architecture. Master OAuth concurrency, rate limits, and schema normalization.