Xero

Before you begin, make sure you have the following:

• A Xero account with administrator permissions.

You can sign-up for a free trial at https://www.xero.com/signup/, if you do not have a Xero account already. Note that you will not need to use this Xero account for anything else than managing the Xero App and, if you want to, becoming a Xero partner later.

In this step we create the App that a user can choose to install into their Xero instance to authorize the integration with your application.

• Navigate to the Xero developer portal and log in, if you are not already logged in.
• On the tab “my Apps”, click “New App”.
• In the pop-up, enter the below details:
  • App Name: This should be your application’s name. When your users link their Xero account, they will see that “App Name” is requesting to integrate with their Xero account.
  • Integration Type: Web app.
  • Company or application URL: The homepage of your company’s website, e.g. https://yourcompany.com/.
  • Redirect URI: Should be set to https://api.maesn.dev/auth/callback/xero

Now it is time to generate the unique client secret for your App.

• Navigate to the Configuration tab of your newly created App
• Click the “Generate a secret” button.
• Note your client id, which you will need together with the client secret in subsequent steps.
• Copy the client secret by clicking the Copy button next to the value. Make sure that you have copied the value before navigating away from this page. Once navigating away, you will not be able to retrieve it again.

In the last step, we setup your API tenant with your App’s details:

• Get in touch with your contact person at maesn to submit the client id and client secret.

If you are not sure who your technical contact is, do not hesitate to reach out to us via support@maesn.com, but do not enter your client credentials directly in the email. That’s not safe!