Microsoft Dynamics 365 Business Central

Business Central API Integration Guide

This guide provides step-by-step instructions for integrating Microsoft Business Central APIs with your iconnek.io iPaaS platform using Microsoft Entra ID (formerly Azure AD) App Registration.

Table of Contents

1. Prerequisites

2. Step 1: Create an App Registration in Microsoft Entra ID

3. Step 2: Configure API Permissions

4. Step 3: Create Client Secret

5. Step 4: Register the Application in Business Central

6. Step 5: Establish the connection with iconnek.io

7. Troubleshooting

Prerequisites

Before starting this integration, ensure you have:

• Administrator access to Microsoft Entra ID (Azure AD)

• Administrator access to Business Central

• Your Business Central environment URL

• A Business Central user with SUPER permissions

Step 1: Create an App Registration in Microsoft Entra ID

1. Sign in to the Microsoft Entra admin center
2. Navigate to App registrations in the left menu

3. Click + New registration

4. Enter application details:

   • Name: iconnek.io Business Central Connector

   • Supported account types: Select "Accounts in this organizational directory only"

   • Redirect URI: https://businesscentral.dynamics.com/OAuthLanding.htm

5. Click Register

6. Once registered, make note of:

   • Application (client) ID

   • Directory (tenant) ID

These values will be needed for your integration configuration.

Step 2: Configure API Permissions

1. In your App registration, select API permissions from the left menu

2. Click + Add a permission

3. Select Dynamics 365 Business Central under Microsoft APIs

   • If you don't see it, search for "Business Central"

4. Select Application permissions (for service-to-service communication without user context)

5. Check the following permissions:

   • API.ReadWrite.All (for full programmatic access)

   • Automation.ReadWrite.All (for workflow automation)

   • Or select specific permissions based on your requirements

6. Click Add permissions

7. Click Grant admin consent for [Your Organization] to pre-authorize these permissions

   • This step is crucial for Application permissions as they require admin consent before they can be used

Step 3: Create Client Secret

1. In your App registration, select Certificates & secrets from the left menu

2. Under Client secrets, click + New client secret

3. Enter a description (e.g., "iconnek.io Integration Secret")

4. Select an expiration period (recommended: 12 months for regular rotation)

5. Click Add

6. IMPORTANT: Copy and securely store the client secret value immediately. It will not be visible again after you leave this page.

Step 4: Register the Application in Business Central

1. Sign in to Business Central with admin credentials

2. Search for Microsoft Entra Applications page using the search icon (🔍)

3. Click New to create a new application registration

4. Enter the Client ID (Application ID) from your Entra ID App registration

5. Enter a meaningful description (e.g., "iconnek.io Integration")

6. Set the State to Enabled

7. Set up the D365 BASIC and D365 BUS FULL ACCESS permission for the user group. Refer to the MC Dynamics 365 Business Central documentation to assign permissions.
8. Save the registration

Step 5: Establish the connection with iconnek.io

• Create a new configuration in iconnek.io for Business Central

• Configure the connector with:

  • Client ID: From App registration

  • Client Secret: From App registration

  • Tenant ID: Your Microsoft Entra ID tenant

  • Environment: Your environment name (e.g., "Production", "Sandbox")

• Establish the connection

Troubleshooting

Common Issues and Solutions

1. Authentication Failed

   • Verify client ID and secret are correct

   • Check that permissions have been granted admin consent

   • Ensure the application is properly registered in Business Central

2. API Access Denied

   • Verify the user has appropriate permissions in Business Central

   • Ensure the user has access to the company you're trying to access

3. Redirect URI Mismatch

   • Make sure the redirect URI in the authentication request exactly matches one configured in the app registration

4. Business Central Specific Errors

   • Check Business Central telemetry for detailed error messages

   • Review application event logs