Setup Xero

Setup Xero

Before you can access data from users using Xero for their accounting, you need to set up a Xero integration in the Railz Dashboard™. You'll need to:

  1. Register a new application on Xero's developer portal.
  2. Retrieve your application's secure keys from the Xero Developer Portal.
  3. Add your secure keys to Railz.

🚧

To link more than 25 companies, become a Xero app partner.

Register your Application

  1. Go to Xero Developer Portal.
  2. Select My Apps.
2880

Xero Developer Portal navigation menu. Click to Expand.

  1. Click New app
2862

My Apps page in Xero Developer Portal. Click to Expand.

  1. Log in using your Xero credentials (or create an account if you don’t already have one).
  2. Enter the following:
    • In the App name box, add a short name for your application. Your customers see this when they authorize your connection to their accounting system.
    • In the Company or application URL box, add a link to your company's website.
    • In the OAuth 2.0 redirect URI box, enter the URI https://auth.railz.ai/xero/finishAuth/railzConnect
403

Xero app details page with redirect URI entered. Click to Expand.

  1. Read and accept Xero's terms & conditions, and then click Create App.

Retrieve your Application Keys

Xero takes you to a page with some information about your new application. You can access this page in future by clicking My Apps and choosing your application from the list.

  1. Select Configuration sidebar menu, and next to the Client Id box, click Copy.
  2. Next, click Generate a secret to retrieve your client secret. If you either save this page or navigate away from it, you won't be able to view the same client secret again and you'll need to generate a new one.
1176

Xero App keys page. Click to Expand.

  1. When the Client Secret appears, keep this tab open. You'll need your secure keys for the next stage of the process.

Add your Secure Keys to Railz

  1. Open the Railz Dashboard™ and log in.
  2. In the left sidebar navigation menu, go to Integrations > Accounting.
  3. Scroll down to the QuickBooks Online integration and click Configure.
Railz Accounting Integration. Click to Expand.

Accounting integrations page in Railz Dashboard. Click to Expand.

  1. Paste in your Client ID and Client Secret, and then click Save & Enable.
Railz Manage Accounting Integration. Click to Expand.

Configure the Xero integration modal. Click to Expand.

How to set up - User Guide

Step-by-step guide on how to integrate with Xero

How to connect- User Guide