Skip to main content

Xero

This page contains the setup guide and reference information for the Xero source connector.

Prerequisites

  • Tenant ID
  • Start Date

Required list of scopes to sync all streams:

  • accounting.attachments.read
  • accounting.budgets.read
  • accounting.contacts.read
  • accounting.journals.read
  • accounting.reports.read
  • accounting.reports.tenninetynine.read
  • accounting.settings.read
  • accounting.transactions.read
  • assets.read
  • offline_access

For Airbyte Cloud:

  • OAuth 2.0

For Airbyte Open Source:

Please follow instruction to obtain all requirements:

  • Client ID
  • Client Secret
  • Refresh Token
  • Access Token
  • Token Expiry Date

Setup guide

Step 1: Set up Xero

Step 2: Set up the Xero connector in Airbyte

For Airbyte Cloud:

  1. Log into your Airbyte Cloud account.
  2. In the left navigation bar, click Sources. In the top-right corner, click + new source.
  3. On the source setup page, select Xero from the Source type dropdown and enter a name for this connector.
  4. Click Authenticate your Xero account.
  5. Log in and Allow access.
  6. Tenant ID - Enter your Xero Organisation's Tenant ID
  7. Start Date - UTC date and time in the format YYYY-MM-DDTHH:mm:ssZ from which you'd like to replicate data.

For Airbyte Open Source:

  1. Create an application in Xero development center.

Supported sync modes

The Xero source connector supports the following sync modes:

Supported streams

Dates transformation

As Xero uses .NET, some date fields in records could be in .NET JSON date format. These dates are transformed into ISO 8601.

Performance considerations

The connector is restricted by Xero API rate limits.

Reference

Config fields reference

Field
Type
Property name
string
access_token
string
tenant_id
string
start_date

Changelog

VersionDatePull RequestSubject
0.2.62024-05-1738330Updating python dependencies
0.2.52024-01-1134154prepare for airbyte-lib
0.2.42023-11-2432837Handle 403 error
0.2.32023-06-1927471Update CDK to 0.40
0.2.22023-06-0627007Update CDK
0.2.12023-03-2024217Certify to Beta
0.2.02023-03-1424005Enable in Cloud
0.1.02021-11-1118666🎉 New Source - Xero [python cdk]