Setting up Xero and Modulr

To set up Xero to be used with Modulr, you need to have:

  • An active Xero account
  • Onboarded to Modulr via the Modulr app in the Xero Marketplace OR an existing Modulr account.
  • Admin permissions.

Once you have Modulr access, follow these steps to connect your Xero access to Modulr:

Jump to:
1. Connect Xero and Modulr →
2. Select Modulr accounts to use →


1. Connecting your Xero access to Modulr

📘

Connections: Delegates and Direct users

Delegates with Admin permissions
If you're a Delegate managing your Clients' accounts – and you have Admin permissions, you can connect your Clients to Xero via the following steps:

  1. From the Customers screen, select the Customer you want to connect, the Customer-specific menu options will appear.
  2. Navigate to the Connections option in the side menu and follow the Connection journey (outlined under this info box).

Delegates without Admin permissions
If you're a Delegate but do not have Admin permissions on your Clients, you'll need to ask their Admin User to follow the connection journey (outlined below), or to grant you Admin permission.

Direct Users
Clients using Modulr directly without an association with a Delegate/Accountant need to follow the journey below to connect Xero and Modulr.

  1. Navigate to Connections in the side menu in the Modulr Portal
The Connections screen in the Modulr Portal

The Connections screen in the Modulr Portal

  1. Select 'Connect to Xero'
  2. Read the disclaimer and confirm you've read the Acknowledgement notice and Consent notice and agree to allow Modulr access to your data.
    • Also, please check the Business details we hold are up to date by selecting the link in the third checkbox (this will open the Business Details screen). Contact [email protected] to make any changes.

  1. Select 'Continue'
  2. You'll be redirected to Xero where you need to enter your Xero account credentials (email address and password) and select 'Log in'.
1440
  1. Select your business name from the dropdown on the Xero page you'll see
1440
  1. Select 'Allow Access'
  2. You'll be redirected back to Modulr where you'll see your Xero account is connected to Modulr ('Authorised')
2880

2. Selecting Modulr accounts to use with Xero

  1. Navigate to 'Connections' from the side menu in the Modulr Portal.
  1. If you're connected to your Xero account, you'll see 'Authorised' on the page displayed. If not, follow the steps in the first section of this page.
  2. Select 'Select Accounts'.
  3. In the box that pops up, select the 'Accounts' field.

  1. If you have a few accounts, you can select them from the dropdown list that appears. If you have many accounts, find the account you want by typing it's name in the field. Results of possible matches will appear. You can select one or more (you can de-select by selecting the selected arrow).
2880
  1. Your selected accounts will appear in a list under the field.

  1. You can go back in to the field and select additional account if you need to.
  2. You can remove selected accounts by selecting the 'x' icon next to the listed accounts.
  3. Once you're happy you've selected the accounts you want to use, select 'Save Selected Accounts'.
  4. You'll be returned to the Connections screen where you'll see the accounts you selected under the Connection details of your Xero account.
  1. These accounts will now be available to you in Xero to use for payments.

If you need to change the account selections, just select 'Edit accounts' and you'll return to the Account Selection pop up where you can add or remove accounts. Select 'Save Selected Accounts' to update your selections.


Existing Modulr Users

If you want to have dedicated accounts to use with Xero, you can create new ones in Modulr.
e.g. you could have one account for Billing purposes and another one for your payrolls
See below:
Can I add more accounts? →


Synced payments post connection

Once the connection has been successfully established, new payments created against bills in Xero will then start to sync with Modulr.

Payments associated with Bills that were created before the connection was established would, however, not appear in Modulr.


See also

Setting up Xero and Modulr →

Xero payment conditions →

Making a payment with Xero →

Making a batch payment with Xero →

Xero notifications →

How do I know when Approvals are waiting? →