> For the complete documentation index, see [llms.txt](https://rudderlabs.gitbook.io/rudderlabs-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rudderlabs.gitbook.io/rudderlabs-1/docs/cloud-extract-sources/xero.md).

# Xero

Step-by-step guide to ingest data from Xero into RudderStack.

[Xero](https://www.xero.com/us/) is a popular cloud-based accounting software, ideal for small and medium-sized businesses, accountants, and book-keepers. It allows you to simplify your accounting and everyday business-related tasks, including bill payments, bank connections, and claiming expenses.

This document guides you in setting up Xero as a source in RudderStack. Once configured, RudderStack automatically ingests your specified Xero data, which can then be routed to your data warehouse destination supported by RudderStack.

**All the Cloud Extract sources support sending data only to a data warehouse destination.**

## Getting Started

To add Xero as a source in RudderStack, follow these steps:

* Log into your [RudderStack dashboard](https://app.rudderlabs.com/signup?type=freetrial).
* From the left panel, select **Sources**. Then, click on **Add Source**, as shown:

![Add Source](https://gblobscdn.gitbook.com/assets%2F-Lq5Ea6fHVg3dSxMCgyQ%2F-MOehucaPVJeehiI6kGM%2F-MOewizUa40U7fa-Ny3L%2F1.png?alt=media\&token=33f4d672-e6f3-4fc8-9b49-09c772d79e93)

* Next, navigate to **Cloud Extract** within the **Sources** directory and select **Xero**.

![Select Xero](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-a94b46817423e56bc3eba1286fba7564181d32eb%2F2%20\(14\).png?alt=media)

* Assign a name to your source, and click on **Next**.

![Assign a name](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-1aca8e24dbd9ff27c5b03f569506c48c4797b4aa%2F3%20\(12\).png?alt=media)

### Setting Up the Connection

* Under **Create new account**, click on **Connect with Xero** and authenticate RudderStack with your Xero account.

![Connect with Xero](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-2e185cc558eecbd4f6db2bce283e31cd1cde1cdb%2Fscreen-shot-2021-02-23-at-6.27.30-pm.png?alt=media)

If you have already connected RudderStack to your Xero account, your credentials should appear automatically under **Use existing credentials**.

### Configuring the Source

* In the next screen, choose the Xero **Tenant ID** . Also, select the **Earliest Report Year** and **Report Starting Month** from which you want RudderStack to ingest the data.

![Report Starting Month](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-9fe5d6262b7094c40f4cbff6f6d01b4bc9096ded%2Fscreen-shot-2021-02-23-at-6.27.16-pm.png?alt=media)

### Setting the Data Update Schedule

* Next, you will be required to set the **Run Frequency** to schedule the data import from your Xero account to RudderStack. You can also specify the time when you want this synchronization to start, by choosing the time under the **Sync Starting At** option, as shown:

![Sync Starting At](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-65a4be0411e6069ed6396e54ee68e57fd7a7e0b6%2Fscreen-shot-2021-02-23-at-6.27.53-pm.png?alt=media)

### Selecting the Data to Import

* Finally, select the appropriate data columns to import. To import all the data, simply click on **Select All**.

![Select All](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-75c22f63c0bc6f151049c69aee833ff276a416a9%2Fscreen-shot-2021-02-23-at-6.28.10-pm.png?alt=media)

That's it! Xero is now successfully configured as a source on your RudderStack dashboard.

RudderStack will start importing data from Xero as per the specified frequency. You can further connect this source to your data warehouse by clicking on **Connect Destinations** or **Add Destinations**, as shown:

![Add Destinations](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-d0279feadd8b647777db775cc1641dd6d940d842%2Fscreen-shot-2021-02-23-at-6.28.27-pm.png?alt=media)

Use the **Connect Destinations** option if you have already configured a data warehouse destination in RudderStack. To configure a data warehouse destination from scratch, click on the **Add Destination** button.

## FAQs

#### Is it possible to have multiple Cloud Extract sources writing to the same schema?

Yes, it is.

We have implemented a feature wherein RudderStack associates a table prefix for every Cloud Extract source writing to a warehouse schema. This way, multiple Cloud Extract sources can write to the same schema with different table prefixes.

## Contact Us

If you come across any issues while configuring Xero as a source on the RudderStack dashboard, please feel free to [contact us](mailto:%20docs@rudderstack.com). You can also start a conversation in our [Slack](https://rudderstack.com/join-rudderstack-slack-community) community; we will be happy to talk to you
