{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"Microsoft Dynamics 365 Business Central integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"microsoft-dynamics-365-business-central-integration","__idx":0},"children":["Microsoft Dynamics 365 Business Central integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrating Microsoft Dynamics 365 Business Central with Frontegg allows your application to read and manage the signed-in user's Business Central data — companies, customers, items, sales and purchase orders, invoices, journals, financial accounts, dimensions, and tax groups — through Frontegg's integration layer using Microsoft OAuth 2.0 and the Business Central REST API v2.0."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Microsoft Entra (Azure AD) tenant with at least the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application Developer"]}," role"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Microsoft Dynamics 365 Business Central environment (Production or Sandbox) provisioned in the same tenant"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Directory (tenant) ID"]}," for that tenant"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"register-an-application-in-microsoft-entra","__idx":1},"children":["Register an application in Microsoft Entra"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-open-app-registrations","__idx":2},"children":["Step 1: Open App registrations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sign in to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://entra.microsoft.com/"},"children":["Microsoft Entra admin center"]}," and navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Entra ID → App registrations"]},". Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New registration"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/microsoft-business-central-1.706c058e33162dd428bd7ae67060ce021e56098208e4f010763dd1031eba797a.1ce25488.png","alt":"App registrations page in Microsoft Entra admin center"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-register-a-new-application","__idx":3},"children":["Step 2: Register a new application"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fill in the registration form:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a name for your application (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Business Central Integration"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Supported account types"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accounts in this organizational directory only (single tenant)"]},". Business Central REST endpoints embed your tenant ID directly, so single-tenant is the correct choice."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URI"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Web"]}," as the platform and enter your Frontegg Redirect URL:",{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://YOUR_MCP_GATEWAY_URL/integration-callback\n"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Register"]},"."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/microsoft-business-central-2.49dd57fd24acae021063f44d3ab062b9c232809addce763cf3ff4ff5b2e2ba33.1ce25488.png","alt":"New application registration form with name, account type, and redirect URI filled in"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-copy-the-application-client-id-and-directory-tenant-id","__idx":4},"children":["Step 3: Copy the Application (client) ID and Directory (tenant) ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After registration, you are taken to the application ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Overview"]}," page. Copy both the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application (client) ID"]}," and the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Directory (tenant) ID"]}," — you will need them when configuring the Frontegg portal."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/microsoft-business-central-3.24fcccd9c068334f3320daf21aef9ffc1e02f53810f66be2b6ea8a5275f335e0.1ce25488.png","alt":"Application overview page with Application (client) ID and Directory (tenant) ID highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-api-permissions","__idx":5},"children":["Configure API permissions"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-add-a-permission","__idx":6},"children":["Step 4: Add a permission"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the left sidebar, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API permissions"]},", then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add a permission"]},". On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Microsoft APIs"]}," tab, scroll down under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["More Microsoft APIs"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dynamics 365 Business Central"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/microsoft-business-central-4.28f5a76d0bb16f2784fde69f6c60d9efc8c4858de75daff94756476aba45b9c3.1ce25488.png","alt":"Request API permissions panel with Dynamics 365 Business Central highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-select-delegated-permissions","__idx":7},"children":["Step 5: Select delegated permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delegated permissions"]},". Select both of the following scopes, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add permissions"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_impersonation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access Business Central as the signed-in user"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Financials.ReadWrite.All"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read and write all Business Central financial data the user can access"]}]}]}]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/microsoft-business-central-5.9c0a3bfc86ce0733625231a7948ea590c13027e018f0921ddfbf32a03f670f2d.1ce25488.png","alt":"Delegated permissions list with user_impersonation and Financials.ReadWrite.All selected"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-6-grant-admin-consent","__idx":8},"children":["Step 6: Grant admin consent"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API permissions"]}," page, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Grant admin consent for {your directory}"]}," and confirm. Both Business Central scopes show as configured under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dynamics 365 Business Central"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/microsoft-business-central-6.31e0803f82bf509f252947ad66b3efc03e0f1947cea04c79a2c766e3aaf5c349.1ce25488.png","alt":"Configured permissions list showing Business Central scopes"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-client-secret","__idx":9},"children":["Create a client secret"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-7-open-certificates--secrets","__idx":10},"children":["Step 7: Open Certificates & secrets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the left sidebar, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificates & secrets"]},", then on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client secrets"]}," tab click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New client secret"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/microsoft-business-central-7.06aafc48198389d8bba6d9a0326034720d9cc8c3d3b8637a3c7df3313ae5a5ce.1ce25488.png","alt":"Certificates and secrets page with New client secret button highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-8-add-a-description-and-expiry","__idx":11},"children":["Step 8: Add a description and expiry"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add a client secret"]}," panel, enter a description (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Integration Secret"]},"), choose an expiry period, and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/microsoft-business-central-8.f28230bcc47caf5e2f83a20a37d719d8e618edd57a611f7e2a97a9508562c08e.1ce25488.png","alt":"Add a client secret panel with description filled in"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-9-copy-the-client-secret-value","__idx":12},"children":["Step 9: Copy the client secret value"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The new secret appears in the list. Copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Value"]}," immediately — it is only displayed once. After you navigate away, you cannot retrieve it again."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Save your Client Secret now","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Client Secret value is only displayed once. After you leave this page, you can only see the Secret ID — not the value. Store the value securely before continuing."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/microsoft-business-central-9.abb3505ce135697ab9a8e62a8d59367d5a00901fa8497ae86c410363df183a2c.1ce25488.png","alt":"Client secret list showing the newly created secret"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"identify-your-business-central-environment","__idx":13},"children":["Identify your Business Central environment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Business Central REST URLs embed two per-tenant identifiers in addition to the Directory (tenant) ID: the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["environment name"]}," and (optionally) a default ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["company ID"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-10-find-your-environment-name","__idx":14},"children":["Step 10: Find your environment name"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://businesscentral.dynamics.com/admin"},"children":["Business Central admin center"]}," and go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Environments"]}," page. Each row lists the environment ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Production"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sandbox"]},") and its ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]},". Use the name exactly as shown — it is case-sensitive."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-11-optional-find-your-default-company-id","__idx":15},"children":["Step 11: (Optional) Find your default company ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sign in to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://businesscentral.dynamics.com/"},"children":["Business Central"]}," and switch to the company you want as the default. The company ID is a GUID returned by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/companies"]}," endpoint of the Business Central REST API — you can call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET https://api.businesscentral.dynamics.com/v2.0/<tenant-id>/<environment>/api/v2.0/companies"]}," to list all companies and their IDs. Leave this field empty in Frontegg to require ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companyId"]}," on every tool call."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":16},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Directory (tenant) ID"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["environment name"]},", enter them in the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to [ENVIRONMENT] → Integrations → Microsoft Dynamics 365 Business Central."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," from your Entra app registration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Directory (tenant) ID"]}," (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business Central environment"]}," name (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Production"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Default company ID"]}," GUID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Base URL"]}," auto-populates as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.businesscentral.dynamics.com/v2.0/<tenant-id>/<environment>/api/v2.0"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your Client Secret to version control."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":17},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/"},"children":["Business Central REST API v2.0 documentation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app"},"children":["Register an application in Microsoft Entra ID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/ai/use-mcp-server-non-microsoft"},"children":["Connect Business Central to non-Microsoft MCP clients"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://entra.microsoft.com/"},"children":["Microsoft Entra admin center"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]},"headings":[{"value":"Microsoft Dynamics 365 Business Central integration","id":"microsoft-dynamics-365-business-central-integration","depth":2},{"value":"Register an application in Microsoft Entra","id":"register-an-application-in-microsoft-entra","depth":3},{"value":"Step 1: Open App registrations","id":"step-1-open-app-registrations","depth":4},{"value":"Step 2: Register a new application","id":"step-2-register-a-new-application","depth":4},{"value":"Step 3: Copy the Application (client) ID and Directory (tenant) ID","id":"step-3-copy-the-application-client-id-and-directory-tenant-id","depth":4},{"value":"Configure API permissions","id":"configure-api-permissions","depth":3},{"value":"Step 4: Add a permission","id":"step-4-add-a-permission","depth":4},{"value":"Step 5: Select delegated permissions","id":"step-5-select-delegated-permissions","depth":4},{"value":"Step 6: Grant admin consent","id":"step-6-grant-admin-consent","depth":4},{"value":"Create a client secret","id":"create-a-client-secret","depth":3},{"value":"Step 7: Open Certificates & secrets","id":"step-7-open-certificates--secrets","depth":4},{"value":"Step 8: Add a description and expiry","id":"step-8-add-a-description-and-expiry","depth":4},{"value":"Step 9: Copy the client secret value","id":"step-9-copy-the-client-secret-value","depth":4},{"value":"Identify your Business Central environment","id":"identify-your-business-central-environment","depth":3},{"value":"Step 10: Find your environment name","id":"step-10-find-your-environment-name","depth":4},{"value":"Step 11: (Optional) Find your default company ID","id":"step-11-optional-find-your-default-company-id","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"category":"Finance","displayName":"Microsoft Dynamics 365 Business Central","seo":{"title":"Microsoft Dynamics 365 Business Central integration"}},"lastModified":"2026-05-19T15:06:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/microsoft-business-central","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}