Integrating with Business Central

Prerequisites

Azure (Entra ID) App Registration

Step 1: Register a new application

Step 2: Copy Application ID and Tenant ID

Step 3: Add a Client Secret

Step 4: Add API Permissions

Business Central Setup

Drivetrain Setup

Prerequisites

To connect Business Central to Drivetrain, you need:

1. An active Microsoft 365 account with access to Business Central and Azure.

2. Permission to register applications and grant admin consent in Azure (typically Global Administrator or Application Administrator).

3. Admin privileges in Drivetrain.

A. Azure (Entra ID) App Registration

Step 1: Register a new application

1. Sign in to the Azure portal.

2. Go to Microsoft Entra ID > App registrations > + New registration.

3. Fill in the following:

• Name: Drivetrain Integration (or any name you prefer)

• Supported account types: Select Accounts in this organizational directory only (Single tenant)

• Redirect URI: Leave blank. Drivetrain uses server-to-server authentication, which does not use a redirect.

4. Click Register.

Step 2: Copy Application ID and Tenant ID

1. On the app's Overview page, copy and save these two values. You will provide both to Drivetrain later:

• Application (client) ID

• Directory (tenant) ID

Step 3: Add a Client Secret

1. In the left navigation, go to Certificates & secrets > + New client secret.

2. Fill in the following:

• Description: Drivetrain connector

• Expires: Pick a duration that fits your rotation policy (e.g., 24 months).

3. Click Add.

4. Immediately copy the secret's Value (not the Secret ID). It will not be shown again. This is the third value to share with Drivetrain.

Step 4: Add API Permissions

1. In the left navigation, go to API permissions > + Add a permission.

2. Select APIs my organization uses (or Microsoft APIs, depending on your tenant) and search for Dynamics 365 Business Central and select it.

3. Choose Application permissions (not Delegated).

4. Tick API.ReadWrite.All and click Add permissions.

5. Back on the API permissions page, click Grant admin consent for {your tenant name}, then click Yes to confirm. The status column should turn green and read "Granted for {tenant}".

API.ReadWrite.All is the only Entra-level permission Microsoft publishes for the Business Central API surface. There is no separate read-only variant. By itself, it only allows the app to call the API. Whether it can read or write any actual data is controlled entirely by the Business Central permission set you assign in Section B. The Drivetrain app will be assigned a read-only permission set, so it cannot perform writes.

B. Business Central - Register the App and Assign Read-Only Permission

This step is required. Azure consent alone does not grant the app any access to Business Central data.

1. Sign in to Business Central as a user with permission to manage Microsoft Entra applications (typically a SUPER user).

2. Use the search icon (Alt+Q) and search for Microsoft Entra Applications (older name: Azure Active Directory Applications). Open it.

3. Click + New.

4. Fill in the following:

• Client ID: Paste the Application (client) ID from Step A2.

• Description: Drivetrain connector

• State: Enabled

5. In the User Permission Sets section on the same page, click + New line and assign the following:

• D365 READ - Grants read-only access across core Business Central tables.

6. Save the page.

C. What to Share with Drivetrain

Once both layers are configured, share the following three values with Drivetrain through a secure channel:

Value	Where to find it
Tenant ID	Azure > App registrations > your app > Overview > "Directory (tenant) ID"
Client ID	Azure > App registrations > your app > Overview > "Application (client) ID"
Client secret	The Value you copied in Step A3

You will also separately tell Drivetrain:

• Your environment name (e.g., Production, or your sandbox name).

Drivetrain Setup

Add the Business Central Connector

1. Once you log in to Drivetrain, click on + to add a new connector on the Data page.

2. Select Microsoft Dynamics 365 Business Central under the Accounting & ERP category.

3. Enter the Tenant ID, Client ID, and Client Secret collected during the steps above and click Next.

4. Enter the Environment name (optional, by default: Production) and click Next.

5. Click Finish setup once the configuration is complete.

6. Your Business Central connection will start showing up on the Data page. Once the sync is complete, you will be able to see your Business Central data on Drivetrain.