Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hotglue.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Connector Details

NameValue
PlatformMicrosoft Dynamics Business Central
Auth TypeOAuth or Client Credentials
DirectionBidirectional
Tap Repohttps://gitlab.com/hotglue/tap-dynamics-bc
Target Repohttps://gitlab.com/hotglue/target-dynamics-bc
Tap Metrics

Usage:

Target Metrics

Usage:

Unified Schema

​
Credentials Setup

There are two separate authentication flows available for the Microsoft Dynamics Business Central connector:
  • OAuth.
  • Client Credentials.
Use only the section that matches your authentication flow.

​
OAuth flow

​
OAuth flow on Microsoft Entra

  1. Sign in to the Microsoft Entra admin center as at least a Cloud Application Administrator.
  2. If you have access to multiple tenants, use the Settings icon in the top menu to switch to the tenant in which you want to register the application from the Directories + subscriptions menu.
  3. Go to Identity > Applications > App registrations and select New registration.
  4. Enter a display name for your application. Users of your application might see this display name when they connect their Dynamics Business Central account.
  5. For Sign-in audience, make sure to allow all accounts to use your application.
  6. For Redirect URI, use https://hotglue.xyz/callback.
  7. Complete your registration by selecting Register.
The next step is to enable this app to access Dynamics Business Central:
  1. On the left-hand panel, navigate to Manage > API Permissions. Add the following permissions:
    • Dynamics 365 Business Central > Financials.ReadWrite.All
    • Dynamics 365 Business Central > user_impersonation
    • Microsoft Graph > User.Read
The last step in the Microsoft Entra application is to retrieve the Client Id and Client Secret:
  1. Select Overview. There, you will see the Application (client) ID. You’ll need to add this Client Id to Hotglue in future steps.
  2. Under Manage > Certificates and Secrets > Client Secrets, add a new client secret. You’ll need to add this client secret value to Hotglue in future steps.

​
Enabling the OAuth Dynamics Business Central Connector on Hotglue

Add the Dynamics Business Central source to a new or existing flow, and add credentials under the source’s credentials tab:
  • OAuth Client Id: Use the Application (client) ID from your Microsoft Entra app registration.
  • OAuth Client Secret: Use the client secret value (not the secret Id) from your Microsoft Entra app.

​
Tenant registration with OAuth

When your tenants sign into their Dynamics Business Central accounts, they’ll need to enter the following information:

​
Client Credentials flow

​
Client Credentials flow on Microsoft Entra

This involves the end user creating their own app in Microsoft Entra. Guide them to:
  1. Sign in to the Microsoft Entra admin center as at least a Cloud Application Administrator.
  2. Go to Identity > Applications > App registrations and select New registration.
  3. Enter a display Name for the application.
  4. For Supported account types, select Single tenant only.
  5. Complete the registration by selecting Register.
The next step is to enable this app to access Dynamics Business Central:
  1. On the left-hand panel, navigate to Manage > API Permissions. Add the following permissions:
    • Dynamics 365 Business Central > API.ReadWrite.All
    • Dynamics 365 Business Central > AdminCenter.ReadWrite.All
The last step in the Microsoft Entra application is to retrieve the Client Id and Client Secret:
  1. Select Overview. There, you will see the Application (client) ID. You’ll need to add the Client Id to Hotglue in future steps.
  2. Under Manage > Certificates and Secrets > Client Secrets, add a new client secret. You’ll need to add the Client Secret value to Hotglue in future steps.

​
Client Credentials flow on Microsoft Dynamics Business Central

This involves the end user granting access to their Microsoft Entra application in Microsoft Dynamics Business Central. Guide them to:
  1. Sign in to Dynamics 365 Business Central with an Administrator account.
  2. Use the search icon in the top-right and open Microsoft Entra Applications.
  3. Select New.
  4. Configure the app record:
    • Client Id: Paste the Application (client) ID from your Entra app registration.
    • Description: Enter a clear name.
    • State: Set to Enabled.
  5. Under User Permission Sets, add the permissions:
    • D365 Basic.
    • D365 FULL ACCESS.

​
Enabling the Client Credentials Dynamics Business Central connector on Hotglue

Add the Dynamics BC Client Credentials source to a new or existing flow. No credentials are necessary in this step.

​
Tenant registration with Client Credentials

When your tenants sign into their Dynamics Business Central accounts, they’ll need to enter the following information:
  • Environment Name: There is a dedicated section explaining How to retrieve the Environment Name.
  • Tenant Id: There is a dedicated section explaining How to retrieve the Tenant Id.
  • Client Id: Use the Application (client) ID from the Microsoft Entra application.
  • Client Secret: Use the client secret value (not the secret Id) from the Microsoft Entra application.

​
How to retrieve the Environment Name

Your users can find their Environment Name by first navigating to the Settings tab in Dynamics Business Central: DBC Settings Icon Then, clicking on Admin Center: DBC Admin Center Finally, they can find all their Business Central environments under Environments. DBC Env Name

​
How to retrieve the Tenant Id

Your users can find their Tenant Id by first navigating to the Settings tab in Dynamics Business Central: DBC Settings Icon Then, clicking on Admin Center: DBC Admin Center Finally, they can find their Tenant Id in the page URL, such as: businesscentral.dynamics.com/{TENANT-Id}/admin DBC Admin Center