TARGET_SYSTEM: businesscentral Microsoft Dynamics 365 Business Central is a comprehensive business management solution for small and medium-sized businesses.
ReadCreateUpdateDelete
Accounts
Async task
Bank accounts
Bills
Bill lines
Booking proposals
Contacts
Customers
Credit notes
Dimensions
Expenses
Files
Goods receipts
Goods receipt lines
Invoices
Invoice lines
Items
Journals
Journal entries
Offers
Offer lines
Payments
Payment terms
Projects
Purchase orders
Purchase order lines
Sales orders
Sales order lines
Suppliers
Tax rates
Transactions
Units
Users
Vendor credits
= Supported by Maesn
= Not supported by Maesn at this time
= Not supported by Business Central

​
How to connect to Microsoft Business Central

To allow your customers to link your application with their Business Central account, you need to set up a Microsoft Entra App and submit your application credentials to maesn.
When targeting Business Central endpoints, it is essential to fill in the environmentName and companyId query parameters. You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.
If you’re experiencing issues with the POST endpoints, ensure that your API Setup is correctly configured in Business Central. In Business Central, search for API Setup and verify that there are templates available for the object you want to create. Some mandatory fields are automatically populated by these templates and cannot be set through the API.
1

Prerequisites

Before you begin, ensure you have the following:
  • An active Azure account with a valid subscription.
  • Cloud Application Administrator permissions on your Azure account.
  • A Microsoft Entra tenant. *An Admin-permissioned Business Central account.
2

Set up a Multitenant Microsoft Entra Application

  • Sign in to your Microsoft Entra account.
  • In the sidebar, select Applications > App registrations.
  • To set up a new application, select “New registration” and enter a name for your application.
  • Select “Multitenant application”.
  • Under “Redirect URI”, select “Web” and enter the following URI: https://api.maesn.dev/auth/callback/businesscentral
  • Click “Register”.
On the “Overview” page of your application, you will find all the information about your application. Note the “Application (client) ID,” as it will be needed later.
3

Set Permissions for Your Application

In you Microsoft Entra application:
  • Select API permissions in the sidebar > Add a permission > Microsoft APIs.
  • Select Dynamics 365 Business Central.
  • Select Application permissions, choose AdminCenter.ReadWrite.All, then click Add permissions.
  • Add another permission by selecting Add a permission again.
  • Select Microsoft APIs > Dynamics 365 Business Central > Delegated Permissions.
  • Tick all boxes, then click Add permissions.
  • When the permissions have been added, click Grant admin consent for <company name> next to the Add permissions button.
4

Generate Credentials

In you Microsoft Entra application
  • Select Certificates & secrets in the sidebar
  • Select Client secrets > New client secret.
  • Add a description for your client secret.
  • Select an expiration period for the client secret or specify a custom duration. Note that the default expiration for a client secret is six months. You may extend the lifetime to minimize the need for frequent credential updates.
  • Click Add.
  • Copy and securely store the secret’s value immediately, as it will not be accessible after you leave this page.
5

Add the Application Credentials to Business Central

In Business Central:
  • Press the search bar and enter “Microsoft Entra Applications”. If you dont find this page, please review your user permissions.
  • Click “New”
  • Add the application (client) ID of your application and enter a brief description for your application.
6

Configure Your Integration in the maesn API

Finally, set up your API tenant with your application’s details. Contact your maesn representative to provide the following information:
  • Application (Client) ID of your application
  • Client Secret (ensure you provide the value, not the ID)
Additionally, please inform us if your client secret expires and you generate a new one. If you are not sure who your technical contact is, do not hesitate to reach out to us.