Breadcrumbs

MS Dynamics Business Central CRM

This guide explains what you, as the customer, need to provide to enable the integration between your Microsoft Dynamics 365 Business Central CRM and our platform.

1. Prerequisites

Before proceeding, ensure you have the following:

  • Admin access to your Microsoft Dynamics 365 Business Central account.

  • Admin access to the Microsoft Entra ID (Azure Active Directory) portal.

2. Create an Azure App Registration

To enable the integration, you need to create an Azure App Registration. Follow these steps:

Steps to Create an Azure App Registration

  1. Open your web browser and go to the Microsoft Entra ID Center.

  2. Sign in with your credentials (the same credentials you use for accessing Business Central).

  3. In the left-hand menu, select App registrations and click on New registration.

image-20251128-063401.png


  1. Provide a name for your application (e.g., Demo BC API).

  2. Under Supported account types, select Accounts in this organizational directory only.

  3. In the Redirect URI field, select Web and enter the following URI:
    https://api.cm.com/marketplace/configuration/redirect-token

  4. Click Register to finalize the registration.

image-20251128-063422.png


3. Configure API Permissions

Steps to Add API Permissions

  1. Navigate to 'Certificates & secrets' in the central menu. Click on the 'New client secret' button, and provide a description along with an expiry date (maximum 24 months). Finally, click 'Add' to finish the process.

image-20251128-063433.png
image-20251128-063441.png


  1. In the Azure App Registration, navigate to API Permissions in the left-hand menu.

  2. Click on Add a permission.

  3. Select Dynamics 365 Business Central from the list.

image-20251128-063455.png


  1. Add the following permissions:

    • Delegated Permissions: API.ReadWrite.All, Automation.ReadWrite.All

    • Application Permissions: app_access

  2. Grant admin consent for the permissions.

image-20251128-063523.png


4. Generate Client Secret

Steps to Generate Client Secret

  1. In the Azure App Registration, navigate to Certificates & Secrets in the left-hand menu.

  2. Click on New client secret.

  3. Provide a description (e.g., Marketplace Integration) and set an expiry date (maximum 24 months).

  4. Click Add and copy the Client Secret value. Save it securely, as it will not be displayed again.

5. Retrieve Required Credentials

Steps to Gather Credentials

  1. Navigate to the Overview section of the Azure App Registration.

  2. Copy the following values:

    • Application (client) ID: This is your clientId.

    • Directory (tenant) ID: This is your tenantId.

image-20251128-063553.png


  1. Go to Certificates & Secrets and Create New Client Secret Copy and Save its Value by giving proper Description and Expires Duration

image-20251128-063602.png


  1. Save these values securely.

6. Retrieve Company ID and Environment Name

Steps to Retrieve Company ID and Environment Name

  1. Log in to your Business Central account using the same credentials as Azure.

image-20251128-063611.png


  1. Navigate to the Admin Center and check your environment. If no environment exists, create a new one and name it appropriately.

  2. Copy the Environment Name.

image-20251128-063619.png


  1. In the Business Central homepage, click on the Search icon and open the Companies tab.

image-20251128-063628.png


  1. Click the Help & Support button (question mark icon) in the top-right corner.

  2. Under the Troubleshooting section, click Inspect pages and data.

  3. In the inspector, search for Id. The first result contains your Company ID. Copy and save it securely.

7. Share Details with the Delivery Team

Once you have the following details, share them with the delivery team:

  • tenantId

  • clientId

  • clientSecret

  • companyId

  • Environment Name