sageaccounting
= On demand - contact us
= Not supported by Sage Accounting
How to connect to Sage Accounting
To allow your customers to link your application with their Sage Accounting account, you need to set up a Sage Accounting App and submit your application credentials to maesn.You may include a companyId when targeting Sage Accounting endpoints to scope requests to a specific company. This step is optional.
To retrieve available company IDs, use the GET /companies endpoint in the Authentication section and use the id field from the response as the companyId.
1
Prerequisites
Before you begin, ensure you have the following:
- An active Sage Accounting account with a valid subscription.
2
Set up a Sage Accounting Application
In this step we create the App that a user can choose to install into their Sage Accounting instance to authorize the integration with your application.
- Sign in to your Sage Accounting account.
- On the welcome page select and click “Create an App”.
- App Name: This should be your application’s name. When your users link their Sage Accounting account, they will see that “App Name” is requesting to integrate with their Sage Accounting account.
- Homepage URL: The homepage of your company’s website, e.g.
https://yourcompany.com/. - Callback URL: Should be set to
https://api.maesn.dev/auth/callback/sageaccounting. - Click “Save”.
3
Create a Sage Accounting user account
Ensure that you are logged out from the developer account from the step above, or open a new tab in an incognito browser. Trying to create a user account while logged in to the developer account may lead to issues.
- Go to the getting started page and use one of the “Sign-up-links” in the table of available trial businesses to set up a trial account. Currently only trial accounts for the UK are avaialble.
- Complete the registration of your user account and your trial company.
4
Configure Your Integration in the maesn API
Set up your API tenant with your application’s details:
- Contact your maesn representative to submit the client ID and client secret.
5
Finally, once the API key configuration is completed. You can start the authentication and authenticate using the user account of the trial business that you created in step 3.Note that you cannot use the developer portal credentials to authenticate as an end user.