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
  • 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

If you're a Delegate managing your Clients' accounts – if you have Admin permissions, select your Customer in Modulr and follow the Connection journey from 'Connections' in the side menu.

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.

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'.
  1. Select your business name from the dropdown on the Xero page you'll see
  1. Select 'Allow Access'
  2. You'll be redirected back to Modulr where you'll see your Xero account is connected to Modulr ('Authorised')

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).
  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.

For other related questions, please also take the time to visit our quick FAQ page, regarding other specific questions around connecting your Xero & Modulr accounts.

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? →