CRMJettyBack to crmjetty.com
Menu

Business Central

Introduction

Hosting and deployment

Account and billing

Connect your CRM

Payments

Widgets

Admin and dashboards

Portal users

Email and notifications

Forms

Lists

Pages

Roles and permissions

Branding and navigation

Workflows

Support and knowledge base

Languages

Login and security

CRM connection and sync

More

Docs / Business Central

Business Central Portal

Guides / Connect your CRM

How to Connect Business Central to CRMJetty Portal

5 min readUpdated
Short answerRegister an app in Microsoft Entra ID with Business Central API permissions and a client secret, add it on the Microsoft Entra Applications page in Business Central, then go to Settings → Portal Settings → Business Central Authentication, verify the OTP, enter the Environment, Client ID, Client Secret and Tenant ID, select Save and Test Connection.

The portal reads and writes Microsoft Dynamics 365 Business Central data through the Business Central APIs, using an app you register in Microsoft Entra ID (formerly Azure Active Directory). You set this up once after the portal is deployed, and again whenever you change the Business Central environment. The same connection is used for both Business Central Customer and Vendor portals.

Before you start

Register an app in Microsoft Entra ID

  1. Sign in to the Azure portal at https://portal.azure.com/.
  2. Search for and open Microsoft Entra ID (formerly Azure Active Directory).
  3. Select App registrations, then New registration.
  4. Enter a name for the app and select Register.
  5. Copy the Application (client) ID and the Tenant ID. You need both later.

Add API permissions

  1. In the app, select API Permission, then Add Permission.
  2. Select Microsoft Graph and add User.Read.
  3. Select Add Permission again, select Dynamics 365 Business Central and add the permissions in the table below.
API Permissions
Microsoft Graph User.Read
Dynamics 365 Business Central AdminCenter.ReadWrite.All, API.ReadWrite.All, app_access, Automation.ReadWrite.All, Financials.ReadWrite.All, user_impersonation
  1. On API permissions, select Grant admin consent for your organization.
  2. Confirm when prompted.

Allow public client flows

  1. In the left menu, select Authentication.
  2. Under advanced settings, set Allow public client flows to Yes.
  3. Select Save.

Create a client secret

  1. In the left menu, select Certificates & secrets.
  2. Select New client secret.
  3. Enter a description and select an expiry time.
  4. Select Add.
  5. Copy the secret Value right away.

Important: You can copy the client secret value only once. If you lose it, create a new secret.

Add the app in Business Central

  1. Sign in to Business Central.
  2. Search for Microsoft Entra Applications and open the page.
  3. Select New.
  4. Enter the Client ID of your Entra ID app, a Description, and the app name.
  5. Set State to Enabled.
  6. Add the user permissions the portal needs.

Connect the portal to Business Central

  1. Sign in to the portal admin.
  2. Go to Settings → Portal Settings → Business Central Authentication.
  3. Enter the OTP sent to the super admin’s registered email address.
  4. In Environment, select Live for your production Business Central or Sandbox for a test environment.
  5. In Client ID, enter the Application (client) ID of your Entra ID app.
  6. In Client Secret, enter the client secret value.
  7. In Tenant ID, enter your tenant ID.
  8. Select Save.
Field What to enter
Environment Live: the production environment with real data and transactions. Sandbox: a test environment that does not affect live data.
Client ID The Application (client) ID of the Entra ID app
Client Secret The client secret value you copied
Tenant ID The tenant ID of your Microsoft Entra directory

Test the connection

  1. Select Test Connection.
  2. Check the connection status on the right side of the page.

Important: If Business Central is already connected and you change the connection, a warning may ask you to choose Preserve Data or Reset Data. Reset Data removes all pages, forms, lists, templates and site configuration. See How to Preserve or Reset Portal Data After Reconnecting.

Next, choose which Business Central tables the portal syncs. See How to Configure Business Central Table Sync.

Troubleshooting

You do not receive the OTP: only the super admin receives the OTP, at their registered email address. Sign in as the super admin and check that SMTP is configured.

The status shows Not connected: re-enter the Client ID, Client Secret and Tenant ID and test again. Check that the app is enabled on the Microsoft Entra Applications page in Business Central. See also How to Fix CRM Connection Errors in CRMJetty Portal.

You lost the client secret value: create a new client secret in Entra ID and enter the new value in the portal.

Did this solve it?No, contact support