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:

  • Register a new application on Xero's developer portal.
  • Retrieve your application's secure keys from the Xero developer portal.
  • Add your secure keys to the Railz Dashboard™.

🚧

Connection Limits for OAuth 2.0 Non-partner Apps

Non-partner Xero OAuth 2.0 apps are limited to 25 connections. If your connections are growing quickly, Xero can increase this limit.

To remove the connection limit, you must gain partner status. For more information see Xero's site.

By default, all Xero integrations in Railz are created using OAuth 2.0.

1. Register your Application

  1. Go to https://developer.xero.com/.
  2. Select My Apps.
Xero - Developer Home. Click to Expand.Xero - Developer Home. Click to Expand.

Xero - Developer Home. Click to Expand.

  1. Select New app
Xero - New App. Click to Expand.Xero - New App. Click to Expand.

Xero - New App. 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

❗️

Not using Railz Connect?

If you are building full custom API integration and not using Railz Connect™ OR still using the old version of our widget (iFrame version), your Redirect URIs must be https://auth.railz.ai/xero/finishAuth

Xero - Redirect URI. Click to Expand.Xero - Redirect URI. Click to Expand.

Xero - Redirect URI. Click to Expand.

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

🚧

Financial Services Providers

Xero has specific requirements about who can gain partner status and how they must build their integration. Xero's partnership program is not available for all use cases and financial services providers may be subject to additional commercial terms. We strongly recommend that you speak with Xero before you build your integration.

If you are a financial services provider, contact our sales team to learn more. If you are not a financial services provider, contact [email protected] with the details of the application you are building.

2. 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 selecting My Apps and choosing your application from the list.

  1. Scroll down to the OAuth 2.0 credentials section, and next to the Client Id box, select Copy.
  2. Next, select 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.
Xero - App Keys. Click to Expand.Xero - App Keys. Click to Expand.

Xero - App Keys. 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 pane, select Integrations.
  3. Scroll down to the QuickBooks Online integration and select Manage.
Railz Accounting Integration. Click to Expand.Railz Accounting Integration. Click to Expand.

Railz Accounting Integration. Click to Expand.

  1. Paste in your Client ID and Client Secret, and then select Save changes.
Railz Manage Accounting Integration. Click to Expand.Railz Manage Accounting Integration. Click to Expand.

Railz Manage Accounting Integration. Click to Expand.

  1. Enable your integration. Go back to Integrations, and use the toggle to update the Xero integration from Disabled to Enabled.

Did this page help you?