Microsoft Business Central

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (OAuth)	✅
Credentials auto-refresh	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
End-user authorization guide	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	🚫 (time to contribute: <48h)
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-type type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

No pre-built syncs or actions available yet.

Not seeing the integration you need? Build your own independently.

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	✅ Not required	Free, self-signup for a Microsoft account and Azure account.
Paid test account	✅ Not required	Free Microsoft account can be used for testing.
Partnership	✅ Not required
App review	⚠️ Conditional	Required only if you want to publish your app to the Microsoft commercial marketplace or if your app needs admin consent for certain permissions.
Security audit	✅ Not required

Setup guide

No setup guide yet.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

Topic	Links
General	Microsoft Entra Admin Center
	Azure Portal
Developer	Microsoft identity platform documentation
	How to register an Application
	OAuth related documentation
	Microsoft Authentication Libraries (MSAL)
	Microsoft Business Central REST API documentation

Contribute useful links by editing this page

Common Permissions

Permission	Description
Financials.Read.All	Read all financial data (no user sign-in required)
user_impersonation	Access as the signed-in user
AdminCenter.ReadWrite.All	Full access to Admin Center API
Automation.ReadWrite.All	Full access to automation
API.ReadWrite.All	Full access to web services API

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({
  end_user: {...},
  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

Connect to Microsoft Business Central

Guide to connect to Microsoft Business Central using Nango Connect UI.