Setup Xero integration on an enterprise environment


To be listed on an Enterprise platform, a Xero developer account must be created. This gives access to developer tools and the ability to register Public Applications and associated API keys. When registering a Public Applications, the validity of API keys is limited to 30 minutes and require the user to re-link it's account manually. Xero offers the possibility to apply for a Partner Application allowing automated renewal of API keys.

Signup for a new Xero account

The first thing to do is to register for a new Xero account https://www.xero.com/signup, make sure to select the correct region. You can use a generic email address when registering (eg: it+myplatform@mycompany.com)

Register public applications

Applications can be managed from https://app.xero.com/Application/ 

From there, create an application per environment (UAT, Production, etc...)

  • Application name: Platform name and environment (eg: MyPlatform UAT)
  • URL of your company or product: MnoHub URL (eg: https://api-hub.uat.my-platform.maestrano.io)
  • OAuth Callback Domain: MnoHub hostname (eg: api-hub.uat.my-platform.maestrano.io)

The Consumer Key and Secret are the ones to be used in MnoHub and Connec!™ to access the customer data.

Apply for a Partner Application

After creating a Public Application, you can register interest to become a Xero Partner. More information can be found here: https://developer.xero.com/documentation/auth-and-limits/partner-applications

Register form to become an App Partner: https://developer.xero.com/partner/app-partner

Xero approval for a Partner application can cover the different environments (UAT and Production)

Manage your Partner Application

Partner Applications require to upload an X509 certificate to authenticate API access. More information can be found on Xero website https://developer.xero.com/documentation/api-guides/create-publicprivate-key