> For the complete documentation index, see [llms.txt](https://knowledge.maica.com.au/maica-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.maica.com.au/maica-knowledge-base/maica-administration-guide/settings/integration-management/xero-integration.md).

# Xero Integration

This section of Maica allows administrators to manage and configure their Xero integration.

Please see the breakdown below for further information on each section: 

### 1. Enable the Integration

Ensure the **Xero Integration toggle** at the top of the settings page is switched to **Enabled**. This is required to activate any of the settings or integrations below. If this toggle is off, Maica will not attempt to communicate with Xero, and synchronisation will not occur.

### 2. Active Connections

Active Connections display which Xero organisations Maica is currently linked to. If multiple companies exist in your Xero instance (e.g. a Production and Demo organisation), Maica will list them here and allow you to select the one to connect with.

{% hint style="info" %}
**For more information on connecting Maica to Xero and setting up your Connection, please** [**click here**](/maica-knowledge-base/maica-administration-guide/integrations/xero-integration.md)**.**
{% endhint %}

### 3. Webhooks

This section configures the Site Maica will use to listen for real-time Xero Notifications.

{% hint style="info" %}
**For more information on setting up Webhooks in Maica, please** [**click here**](/maica-knowledge-base/maica-administration-guide/integrations/xero-integration.md#webhooks)**.**
{% endhint %}

### 4. Synchronisation 

This section controls how invoices are synchronised between Maica and Xero.

* **Invoice Xero Sync Flow**: Select the Automation flow responsible for pushing invoices to Xero. 
* **Run Now**: Click this button to manually trigger the Invoice Synchronisation. 

Once configured, Maica will regularly run the selected flow to keep Xero updated with Maica invoice records.


---

# 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, and the optional `goal` query parameter:

```
GET https://knowledge.maica.com.au/maica-knowledge-base/maica-administration-guide/settings/integration-management/xero-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.