Microsoft Business Central

​

Overview

​

Pre-built tooling

​

Access requirements

​

Setup guide

​

Useful links

​

Common Permissions

​

API gotchas

• See particularly the tenantId parameter under Get a token.
• When requesting Application Permissions that require admin consent, an Microsoft Entra ID administrator must pre-authorize the permissions. Without admin consent, the app cannot obtain tokens for those scopes.
• For multitenant applications, each tenant administrator must grant consent to the app’s required permissions before access is granted in their tenant.
• The .default scope is a special scope that tells Azure AD to issue a token containing all the Application Permissions that have already been granted (consented) for your app on that resource. Using .default ensures your app receives permissions consistent with those configured and consented at the tenant or organization level.
• The .default scope can’t be combined with the scopes registered in the Azure portal. So either just use the .default scope or remove it to list out explicit parameters that are required. If you attempt to combine them you’ll receive the following error

.default scope can't be combined with resource-specific scopes

• To add the .default scope when creating a connection, use the integrations_config_defaults parameter in createConnectSession:

const { data } = await nango.createConnectSession({
  tags: {
    end_user_id: '<END-USER-ID>',
    end_user_email: '<END-USER-EMAIL>',
    organization_id: '<ORGANIZATION-ID>'
  },
  integrations_config_defaults: {
    "microsoft-business-central": {
      connection_config: {
        oauth_scopes: "https://api.businesscentral.dynamics.com/.default",
      },
    },
  },
});

• No user interaction is involved when using the Microsoft Business Central provider. Therefore, a Microsoft Entra ID administrator must grant consent for the required Application Permissions ahead of time. This can be done through the Azure Portal or by using the admin consent endpoint.
  Contribute API gotchas by editing this page

​

Going further