> For the complete documentation index, see [llms.txt](https://docs.getsphere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getsphere.com/features/integrations/prebuilt-connectors/xero-integration.md).

# Xero Integration

Integrating Xero with Sphere enables a) seamless import of transaction data and b) live tax calculation within Xero invoices.

This guide provides detailed, step-by-step instructions for connecting your Xero account to Sphere using the secure OAUTH flow.

### Configure Data Synchronization from Xero to Sphere

1. In your Sphere account, select the **Xero** tile and click the “**Connect**” button.

<figure><img src="/files/xbHqMLymRw14WNSXLDfR" alt=""><figcaption></figcaption></figure>

2. You will be redirected to a Xero OAUTH authorization link, where you'll need to grant Sphere permission to connect to your Xero account.

<figure><img src="/files/jSUAwZSbGPzrjt82guZ1" alt=""><figcaption></figcaption></figure>

3. After granting access, you'll be redirected back to Sphere, where you'll see that your Xero account has been successfully connected.

<figure><img src="/files/PldpvUC1sKZXBzNBKGxr" alt=""><figcaption></figcaption></figure>

4. You’re all set! If the connection is successful, data will begin importing, and after some time, your products will appear in **Sphere**.

<figure><img src="/files/851r1HgpzUlKK9HIjO9Y" alt=""><figcaption></figcaption></figure>

### Tax Calculation in Xero

1. Ensure all your 'Subscribed Regions' in Sphere have 'Tax Calculations' settings switched to Yes (see video [here](https://www.loom.com/share/6254e72b130c44808a59513046ee60ea?sid=463c87f3-0683-4622-a479-0f960620d332) on how to ensure this is done).

<figure><img src="/files/5Jki3I9DBNxkpIKPprtq" alt=""><figcaption></figcaption></figure>

2. You can go ahead and create an invoice in Xero for that region. Once you've saved your changes, refreshing the page will show the taxes added to the Xero invoice by Sphere. Updating credit notes with taxes may take some time — up to 15 minutes at most.

### Set up a connection between your Xero sandbox account and Sphere

To integrate your Xero sandbox (test) environment with Sphere, it’s crucial to **select the sandbox organization** rather than the live organization during the OAuth connection process. This ensures that all data and interactions occur within the safe confines of your test environment without affecting your production data.

**Note:** Before proceeding, please check with your Sphere representative to confirm that your Sphere test account is properly set up and aligned with your testing requirements.

The connection process to Sphere is the same—simply follow the steps outlined above for the production setup.

<figure><img src="/files/HcJhMWHrgRtlhscO6PJd" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getsphere.com/features/integrations/prebuilt-connectors/xero-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.