---
title: Xero Integration
slug: bubble/xero-integration
description: Add Xero oauth and API integration to your Bubble.io app
docTags: 
createdAt: 2021-01-09T12:08:26.000Z
---

The Pathfix Xero (Customer + Invoice) plugin enables integration from your Bubble app to your user's Xero for Customer and Invoice. 

The plugin will render the Connect button (UI) and calls the relevant Xero API automatically. No configurations required to get the plugin working.

This documentation will show setup guide and a few example use cases.



### Setup

The plugin is available in the Bubble Plugin store. 

IMPORTANT: You need to install the [Pathfix OAuth Connector](https://docs.pathfix.com/bubble/pathfix-oauth-connector) first before proceeding to  install this plugin

- Click on **Add Plugin** 
- Search and select the Xero plugin **by Pathfix Inc.** and install it ([click here to access the plugin](https://bubble.io/plugin/xero-customer-+-invoice-1623849702595x482779049920299000))
- Under `x-partner-key (shared headers)`:
  - add your Pathfix x-partner-key from the Keys section of your Pathfix account 
  - If you do not have a Pathfix account you can [sign up here](https://app.pathfix.com), configure your Xero integration  and get your Pathfix Keys



::Image[]{src="https://api.archbee.com/api/presign/E6H_--BmYJWG_yGaOUOxt/10UiYmfBujjB9ougbhz3W_image%20%2820%29.png" size="84" caption="Image: plugin page" position="center" showCaption="true"}



- Navigate to the Design section and select the `Pathfix Connector` element and select **All Providers configured in my Pathfix Account** 



::Image[]{src="https://api.archbee.com/api/optimize/E6H_--BmYJWG_yGaOUOxt/GMdMBOOwctiNByG8Rs36D_image.png" size="58" width="888" height="921" caption="Image: Enable provider" position="center" showCaption="true"}



Once installed, there are no additional configurations required to get the Plugin to work. You can setup your workflow in Bubble for the Xero API. 

The Connect button will automatically be added to your page that contains the Pathfix Connector element.  No additional settings are required.



### Calls and Actions available 

Once installed, you can add Dropdown, Text and other elements to pull in Xero data for your users using the plugin and setup Workflows to Xero actions. 

List of Calls and Actions available (version 1.0.2):



::Image[]{src="https://api.archbee.com/api/optimize/E6H_--BmYJWG_yGaOUOxt/WNCq37ehHMGRjF3ewrgr4_image.png" size="72" width="1088" height="367" caption="Image: Actions and Calls" position="center" showCaption="true"}



The plugin calls the relevant APIs, there is no coding or API setup required. Simply select the data type from the API provider dropdown 



::Image[]{src="https://api.archbee.com/api/optimize/E6H_--BmYJWG_yGaOUOxt/ajT4zzLJkLz8e5u3-YOrf_image.png" size="72" width="1443" height="738" caption="Image: Selecting external API" position="center" showCaption="true"}





::Image[]{src="https://api.archbee.com/api/optimize/E6H_--BmYJWG_yGaOUOxt/FPsApVHqiEasPpd9hCPv-_image.png" size="36" width="644" height="1079" caption="Image: Xero data" position="center" showCaption="true"}



### Whitelabel

The plugin works with a *Pathfix ClientID and ClientSecret*. This means that when your user goes through the OAuth process to grant access, they will see the request **by Pathfix**.

You can use your own ClientID and ClientSecret in the plugin and whitelabel it. 

Follow this document to [Whitelabel Your Connectors](docId\:Z5C7baMeiwG18rz-Dm3m4) 



### Works with

Bubble.io