Xero

🚀 Quickstart

Connect to Xero with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Xero.

Authorize Xero

Go to Connections -> Add Test Connection -> Authorize, then log in to Xero. Later, you’ll let your users do the same directly from your app.

Call the Xero API

Let’s make your first request to the Xero API. Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/api.xro/2.0/Contacts" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/api.xro/2.0/Contacts',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Xero Integration Guides

Nango maintained guides for common use cases.

How to register your own Xero OAuth app
Register an OAuth app with Xero and obtain credentials to connect it to Nango
How to configure Xero webhooks with Nango
Learn how to set up webhook notifications from Xero to Nango

Official docs: Xero API documentation

🧩 Pre-built syncs & actions for Xero

Enable them in your dashboard. Extend and customize to fit your needs.

Accounts

Function name	Description	Type	Source code
`create-account`	Create an account in the Xero chart of accounts.	Action	🔗 Github
`get-account`	Retrieve an account by AccountID.	Action	🔗 Github
`list-accounts`	List accounts in the Xero chart of accounts.	Action	🔗 Github
`update-account`	Update an existing account.	Action	🔗 Github

Bank Transactions

Function name	Description	Type	Source code
`create-bank-transaction`	Create a spend or receive money bank transaction	Action	🔗 Github
`get-bank-transaction`	Retrieve a bank transaction by BankTransactionID.	Action	🔗 Github
`list-bank-transactions`	List bank transactions with filters and pagination.	Action	🔗 Github
`update-bank-transaction`	Update an existing bank transaction.	Action	🔗 Github

Contacts

Function name	Description	Type	Source code
`create-contact`	Create a contact in Xero.	Action	🔗 Github
`get-contact`	Retrieve a contact by ContactID	Action	🔗 Github
`list-contacts`	List contacts with filters and pagination.	Action	🔗 Github
`update-contact`	Update an existing contact.	Action	🔗 Github

Credit Notes

Function name	Description	Type	Source code
`create-credit-note`	Create a credit note for a contact	Action	🔗 Github
`get-credit-note`	Retrieve a credit note by CreditNoteID.	Action	🔗 Github
`list-credit-notes`	List credit notes with filters and pagination.	Action	🔗 Github
`update-credit-note`	Update an existing credit note.	Action	🔗 Github

General Ledger

Function name	Description	Type	Source code
`general-ledger`	Sync Xero general ledger journals, each containing journal lines with account and tax details.	Sync	🔗 Github

Invoices

Function name	Description	Type	Source code
`create-invoice`	Create a sales or purchase invoice.	Action	🔗 Github
`get-invoice`	Retrieve an invoice by InvoiceID.	Action	🔗 Github
`update-invoice`	Update an existing invoice.	Action	🔗 Github

Items

Function name	Description	Type	Source code
`create-item`	Create an inventory or catalog item.	Action	🔗 Github
`get-item`	Retrieve an item by ItemID.	Action	🔗 Github
`list-items`	List items with optional filtering.	Action	🔗 Github
`update-item`	Update an existing item.	Action	🔗 Github

Payments

Function name	Description	Type	Source code
`create-payment`	Create a payment against an invoice or credit note.	Action	🔗 Github
`get-payment`	Retrieve a payment by PaymentID.	Action	🔗 Github

Purchase Orders

Function name	Description	Type	Source code
`create-purchase-order`	Create a purchase order for a contact.	Action	🔗 Github
`get-purchase-order`	Retrieve a purchase order by PurchaseOrderID.	Action	🔗 Github
`list-purchase-orders`	List purchase orders with filters and pagination	Action	🔗 Github
`update-purchase-order`	Update an existing purchase order.	Action	🔗 Github

Tenants

Function name	Description	Type	Source code
`get-tenants`	Fetches all the tenants the connection has access to. This can be used to set the metadata to the selected tenant.	Action	🔗 Github
`list-tenants`	List Xero tenants connected to the current OAuth token.	Action	🔗 Github

Others

Function name	Description	Type	Source code
`list-invoices`	List invoices with filters and pagination.	Action	🔗 Github
`list-payments`	List payments with filters and pagination	Action	🔗 Github
`accounts`	Sync accounts from the Xero chart of accounts.	Sync	🔗 Github
`bank-transactions`	Sync bank transactions from Xero.	Sync	🔗 Github
`contacts`	Sync contacts from Xero.	Sync	🔗 Github
`credit-notes`	Sync credit notes from Xero.	Sync	🔗 Github
`invoices`	Sync invoices from Xero.	Sync	🔗 Github
`items`	Sync inventory and catalog items from Xero.	Sync	🔗 Github
`organisations`	Sync Xero organisation records for connected tenants.	Sync	🔗 Github
`payments`	Sync payments from Xero.	Sync	🔗 Github
`purchase-orders`	Sync purchase orders from Xero.	Sync	🔗 Github

Overview

700+ APIs & Integrations

🚀 Quickstart

📚 Xero Integration Guides

🧩 Pre-built syncs & actions for Xero

Accounts

Bank Transactions

Contacts

Credit Notes

General Ledger

Invoices

Items

Payments

Purchase Orders

Tenants

Others

Overview

700+ APIs & Integrations

Documentation Index

​🚀 Quickstart

​📚 Xero Integration Guides

​🧩 Pre-built syncs & actions for Xero

​Accounts

​Bank Transactions

​Contacts

​Credit Notes

​General Ledger

​Invoices

​Items

​Payments

​Purchase Orders

​Tenants

​Others

🚀 Quickstart

📚 Xero Integration Guides

🧩 Pre-built syncs & actions for Xero

Accounts

Bank Transactions

Contacts

Credit Notes

General Ledger

Invoices

Items

Payments

Purchase Orders

Tenants

Others