# Xero

## **Connector Overview**

<figure><img src="https://4017407078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJn-9R_dn6dvcGNcdk%2Fuploads%2FWsyQdwWVdUR2JO5gL37i%2Fimage.png?alt=media&#x26;token=1f3996bc-108b-4f86-a12e-b13d57f305dc" alt="" width="188"><figcaption></figcaption></figure>

Xero is a cloud-based accounting software platform that helps businesses manage their finances, track transactions, and streamline their bookkeeping tasks.

## **Authentication Type**

OAuth

## **Webhook Supported**

Yes, Xero supports webhooks at an integration-level. To configure these, simply add your Xero integration webhook URL as the "Delivery URL" in your Xero Developer Portal under Apps > [Webhooks](https://developer.xero.com/documentation/guides/webhooks/overview/).

## **Secrets**

* PAN\_SEC\_XERO\_ACCESS\_TOKEN
* PAN\_SEC\_XERO\_SCOPE
* PAN\_SEC\_XERO\_EXPIRES\_IN
* PAN\_SEC\_XERO\_CLIENT\_ID
* PAN\_SEC\_XERO\_CLIENT\_SECRET
* PAN\_SEC\_XERO\_TENANT\_URL
* PAN\_SEC\_XERO\_WEBHOOK\_KEY

## **API Client Supported**

No

## **Requirements for Provisioning**

In order to provision your connector, the following Xero information must be gathered:

* Client ID
* Client Secret
* Webhook Key
  * *This is not required for provisioning, but if you wish to utilize webhooks, then it must be supplied*
* Scopes

## **How to Connect Your Integration**

Upon successfully creating a tenant, you will perform the following steps to connect to Xero:

1. Click on Reconnect
2. Log into your Xero Account
3. Select which Organization you want to connect
   1. If you have more than one organization, there should be a dropdown available\
      ![](https://4017407078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJn-9R_dn6dvcGNcdk%2Fuploads%2Ft4LgCVmxivVX0ANO6E05%2Fimage.png?alt=media\&token=7945e9f2-92ef-4da3-bbaf-3ba341b1595c)

## **API Resources**

For more information on how to utilize the Xero API, feel free to reference the following [documentation](https://developer.xero.com/documentation/api/accounting/overview).


---

# Agent Instructions: 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.pandium.com/connectors/connectors-101/xero-oauth.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.