Xero connector icon

Xero Connector

Embed customer-facing Xero workflows inside your SaaS. Use Cyclr’s low-code builder to sync invoices, contacts and payroll, orchestrate cross-app automations and publish governed integrations to your white-label marketplace.

Build with this Connector Talk to an integration expert
01

Faster time to market

Ship Xero integrations using low-code flows, not hand-built pipelines.

02

Self-service integrations

Let customers connect Xero and manage connections in-app.

03

Governed MCP tools

Expose vetted Xero methods as controlled marketplace tools.

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

Overview

Cyclr’s Xero connector lets product and engineering teams embed two-way accounting and payroll integrations into multi-tenant SaaS apps. Build and orchestrate workflows that sync invoices, contacts and payroll across systems, expose vetted Xero operations as governed MCP tools and publish integrations inside your product without maintaining bespoke connector code.

PRODUCT USE CASES

Use cases

Build in-app automations that keep customer financial data current, eliminate manual reconciliation and add premium integration features to your product. Use Cyclr to orchestrate multi-step Xero workflows and expose them as controlled tools in your embedded marketplace.

Automated invoice sync

Create workflows that automatically push invoices from your app into customers’ Xero ledgers and reconcile payments.

Payroll and employee sync

Sync employee records, payroll batches and payruns between your SaaS HR module and Xero payroll endpoints.

Customer contact and billing sync

Keep customer and billing contact records aligned between your product and Xero to reduce duplicate data entry.

ORCHESTRATION

How Xero works with Cyclr

Cyclr sits between your SaaS product and Xero to handle authentication, govern access and orchestrate every API call per customer, at scale.

  1. 1

    Your SaaS product

    Your app requests an action for a specific customer.

  2. 2

    Cyclr orchestration

    Cyclr authenticates, applies policies and routes the request.

  3. 3

    Xero

    Xero processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore Xero methods you can orchestrate through Cyclr.

Purchase Orders6

List Updated Purchase Orders

Action

Retrieves a list of all new and updated purchase orders since last run time.

Update Purchase Order

Action

Update an existing purchase order.

Create Purchase Order

Action

Create a new purchase order.

List Purchase Orders

Action

Retrieves a list of all purchase orders.

Delete Purchase Order

Action

Mark an existing purchase order as deleted.

Get Purchase Order

Action

Retrieves the details of a specific purchase order.

Repeating Invoices3

List Repeating Invoice History

Action

Retrieves a history of repeating invoice.

Get Repeating Invoice

Action

Retrieves a repeating invoice.

List Repeating Invoices

Action

Retrieves a list of repeating invoices.

Invoices9

Update Invoice

Action

Allows you to update an invoice.

Get Invoice

Action

Get details of the specified Invoice.

List Invoices

Action

Retrieves a list of invoices.

Create Invoice

Action

Allows you to create an invoice.

List Updated Invoices

Action

Retrieves a list of new and updated invoices since last run time.

List Updated AR Invoices

Action

Retrieves a list of new and updated AR invoices since last run time.

List AR Invoices

Action

Retrieves a list of AR invoices.

List AP Invoices

Action

Retrieves a list of AP invoices.

List Updated AP Invoices

Action

Retrieves a list of new and updated AP invoices since last run time.

Payments6

List Updated Payments

Action

Retrieve the full chart of new and updated payments since last run time.

Get Payment

Action

Retrieve the details of a specified payment.

Apply Payment To Invoice

Action

Apply a payment to an approved AR or AP invoice.

Reverse Payment

Action

Reverse payments to invoices, credit notes, prepayments & overpayments. Note that payments created via batch payments and receipts are not supported.

Get Payment History

Action

View a summary of the actions made by all users to a specified payment.

List Payments

Action

Retrieve the full chart of payments.

Journals6

Get Journal

Action

Gets details of the specified Journal.

List Updated Manual Journals

Action

Returns a list of new and updated Manual Journals since last run time.

List Updated Journals

Action

Returns a list of new and updated Journals since last run time.

List Manual Journals

Action

Returns a list of Manual Journals.

Get Manual Journal

Action

Gets details of the specified Manual Journal.

List Journals

Action

Returns a list of Journals.

Tax Rates5

Update Tax Rate

Action

Update a Tax Rate.

Get Tax Rate

Action

Returns details of the specified Tax Rate.

List Tax Rates by Type

Action

Returns details of the specified Tax Rate.

List Tax Rates

Action

Returns a list of Tax Rates.

Create Tax Rate

Action

Creates a Tax Rate.

Employee Payment Methods - NZ2

Get Payment Method

Action

Retrieves payment method for an active employee.

Create Payment Method

Action

Adds payment method for an active employee.

Items2

List Updated Items

Action

Retrieves a list of new and updated items since last run time.

List Items

Action

Retrieves a list of items.

Suppliers1

List Suppliers

Action

Returns a list of all suppliers.

Organisation1

Get Organisation

Action

Gets details of the Organisation.

Attachments1

Upload Attachment

Action

Upload attachment to document.

Expenses1

List Expenses

Action

Returns a year to date profit and loss for customers and suppliers for a given organisation, including detailed contact information.

Employee Payment Methods - UK2

Get Payment Method

Action

Retrieves payment method for an active employee.

Create Payment Method

Action

Adds payment method for an active employee.

Bank Transactions3

Get Bank Transaction

Action

Get the details of the specified Bank Transaction.

List Updated Bank Transactions

Action

List new and updated bank transactions since last run time.

List Bank Transactions

Action

List bank transactions.

Contacts5

Get Contact

Action

Allows you to retrieve a details of the specified Contact.

List Contacts

Action

Allows you to retrieve a list of contacts.

List Updated Contacts

Action

Allows you to retrieve a list of new and updated contacts since last run time.

Update Contact

Action

Allows you to update an existing contact.

Create Contact

Action

Allows you to create a new contact.

Accounts8

Add Account

Action

Adds a new Account

Update Account

Action

Updates an Account

List Accounts

Action

Retrieve the full chart of accounts.

Get Account

Action

Gets details of the specified Account.

List Updated Accounts

Action

Retrieve the full chart of new and updated accounts since last run time.

Get Accounts by Type

Action

Retrieve the full chart of accounts.

Delete Account

Action

Deletes the specified Account.

Get Accounts by Code

Action

Retrieve an account with the given code.

TECHNICAL DETAILS

Xero integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing Xero integrations in Cyclr.

API and authentication

API host
https://api.xero.com
Authentication
OAuth 2.0 (Auth code and client credentials)
Credentials

Client ID, Client Secret, Redirect URI, Webhook signing key, required scopes

Method categories

Accounting, Payroll, Contacts, Invoices, Files, Projects APIs; read, create, update, delete operations.

View vendor API documentation →

Pagination and rate limits

Pagination

Many endpoints use page-based pagination (commonly up to 100 items per page). Use If-Modified-Since to fetch deltas efficiently.

Rate limits

Xero enforces 5 concurrent calls, 60 calls per minute and 5,000 calls per day per tenant; app-level minute limit 10,000. Exceeding returns 429.

IMPLEMENTATION

Authentication at a glance

Xero uses OAuth 2.0. Register an app to get client_id and client_secret; tokens are issued at identity.xero.com and must be refreshed before expiry.

Authentication method
OAuth 2.0 (Auth code and client credentials)
Credential required

Client ID, Client Secret, Redirect URI, Webhook signing key, required scopes

Before you begin:

Register a Xero app and exact redirect URIs; tokens expire and require refresh.

View setup guide

COMMON QUESTIONS

Frequently asked questions

Xero uses OAuth 2.0. Register an app on developer.xero.com to obtain a client_id and client_secret; standard auth code and client credentials flows are available.

Yes. Xero supports webhooks. Each webhook POST is signed using HMAC-SHA256 and includes an x-xero-signature header for verification.

Cyclr orchestration adds retry, backoff and batching patterns and centralizes error handling to help you operate within Xero’s rate limits.

Use Cyclr to wrap Xero methods as governed MCP tools, control which operations are visible and publish them in your embedded marketplace.

KEEP EXPLORING

Related resources and connectors

Documentation

Accounting Integrations: Keep your Financial Data Flowing

Read more →Product

What is iPaaS?

Read more →Product

MCP PaaS

Read more →Related connector

Exact

Related Accounting connector for customer-facing integration workflows.

Related connector

Freshbooks Classic

Related Accounting connector for customer-facing integration workflows.

Related connector

PayFit

Related Accounting connector for customer-facing integration workflows.

Let Cyclr handle the integrations.

You focus on building the product your customers love.

Start building for free Get a demo