Register a Dynamics 365 Business Central Application in Azure

Before using the integration it is necessary to configure credentials that will be used for accessing API of the Dynamics 365 Business Central instance. To configure the credentials, follow the instructions below.

1. Register an Azure AD application for authentication to Business Central

  1. Sign in to the Azure portal: https://portal.azure.com

  2. Search for “App registrations”

  3. Create a new registration

    1. Name. A unique name for your application

    2. Supported account types. Select Accounts in this organizational directory only (Microsoft only - Single tenant)

    3. Request URI.

      1. Choose type “Web”

      2. Specify as URL: https://businesscentral.dynamics.com/OAuthLanding.htm

        1. attention: this URL is case sensitive!

  4. Click “Register

image-20241011-133900.png
image-20241011-133900.png
Register an application in the Microsoft Azure Admin Portal
  1. After that, an overview of your application will be displayed The following information from this page will be required to set up the integration:

    1. Application (client) ID . This is the application ID that will be used as the user name in Business Central

    2. Copy and save this Application (client) ID, as it will be needed in BC

Copy and save the Application (client) ID
  1. Create a client secret for the registered application.

    1. Select Certificates & secrets

    2. Select “+ New client secret.”

    3. Add a description, select a duration, and click Add.

Create a client secret for the registered application.
  1. Make sure to copy and save the secret as it will not be displayed ever again.

Make sure that you copy and save the Client Secret “Value” field immediately! It will be used as a password in the integration.

Copy and save the Client Secret “Value” field!
  1. Grant the registered application the API.ReadWrite.All permission to the Dynamics 365 Business Central.

    1. Select API permissions > Add a permission > Microsoft APIs.

    2. Select Dynamics 365 Business Central.

Add API permissions (1/2)
  1. Select Application permissions, select API.ReadWrite.All, then select Add permissions.

Add API permissions (2/2)
  1. Grant admin consent for that permission by selecting it in the list and then choosing Grant admin consent for <tenant name>.

Make sure to grant admin consent to the API (1/2)
Make sure to grant admin consent to the API (2/2)