Integrate Microsoft Dynamics 365 Business Central: Step-by-Step Guide

We have outlined the steps below to integrate with Microsoft Dynamics 365 Business Central below. Following these steps should save you immense time that would have otherwise been spent on unnecessary research and navigation.

⚠️ This post is not an in-depth tutorial on how to build OAuth apps in general, some prior knowledge of how OAuth apps work is required.

Integrating with Microsoft Dynamics 365 Business Central REST API can be a great way to automate your business processes and improve your overall efficiency. In this blog post, we'll walk you through the steps to integrate with the Microsoft Dynamics 365 Business Central API by creating an Azure AD OAuth App and show you how it can benefit your business.

Sign up for a Microsoft Dynamics 365 Business Central account

Before you can start integrating with the Microsoft Dynamics 365 Business Central API, you'll need to sign up for a Microsoft Dynamics 365 Business Central account. You can sign up for a trial account or upgrade to a paid plan.

Create an application on Azure AD

1. Visit the App registration page on Azure AD

2. Click "New Registration"

3. Enter in the details of the app, with the redirect URI.

4. Select the account type based on whether you want to make this OAuth app available to others (Multitenant) or if you want to use it only in your organization (Single tenant).

5. Submit the form by clicking "Register"

6. You can get your OAuth Client ID in the Overview tab, copy and store it somewhere.

7. On the app details page, click "Manifest" on the sidebar and change the value of allowPublicClient in the JSON editor to true

8. Click "API permissions" and click "Add a permission"

9. Select "Dynamics 365 Business Central"

10. Check "user_impersonation" permission and "Financials.ReadWrite.All" and click "Add permissions" at the bottom.

11. You can also grant admin consent for your organization by clicking, "Grant admin consent for ..."

12. Click "Certificates & secrets" and click "New client secret"

13. Enter a friendly name for the secret and click "Add"

14. You will be shown the Client Secret for the OAuth app, copy it and store it somewhere safe.

Post creating an OAuth application, you can either use Microsoft's Authentication libraries to add OAuth flow into your web application or any other OAuth client library, you can find the OAuth URLs and flows here.

IMPORTANT: When doing OAuth flow using a non-Microsoft library, add the Web API endpoint (which you'll find in the next section) as part of the scope. Add the following to the scope parameter -> https://api.businesscentral.dynamics.com/.default

Integrate with Microsoft Dynamics 365 Business Central API

Once you have your OAuth credentials and have granted the necessary permissions to your Azure AD OAuth App, you can start integrating with Microsoft Dynamics 365 Business Central API. The Microsoft Dynamics 365 Business Central API documentation provides detailed instructions on how to perform various actions, such as creating a customer, updating an invoice, and more. You can use any programming language that supports HTTP requests to communicate with the API.

Following these steps will you put on the right path to integrating Microsoft Dynamics 365 Business Central

Are you looking to natively integrate with all leading Accounting applications such as QuickBooks Online, Wave, FreshBooks, Sage, and Xero? Use Truto.one’s Unified API for Accounting for free. It’s built for developers by developers to natively integrate all accounting applications in one go.

If you have any questions or run into a roadblock, feel free to reach out to us at support@truto.one, we’ll be happy to help.