Business Central integration: start with the REST API, add a custom API
Business Central offers three kinds of web service, REST APIs, OData and SOAP, and Microsoft says to use the REST APIs. When the standard API lacks a field, a developer builds a custom API page in AL, the code language of Business Central. Our team has taken Business Central live, and this page maps each integration job to the route Microsoft documents for it.
Three web service types, and the one Microsoft recommends
Pick the REST API first. Microsoft’s web services page calls REST API web services the recommended way to build and use web services. The built-in APIs need no code and little setup.
Scroll the table sideways to see every column.
| Type | What it publishes | Where it stands in Microsoft’s docs |
|---|---|---|
| REST API: API v2.0 and custom APIs | API pages and API queries | Recommended; built on OData version 4 |
| OData | Pages, codeunits and queries, as OData V4 endpoints | Supported; OData V3 was removed in 2021 release wave 1; from version 30.0 (2027 release wave 1) a Microsoft page can no longer be an OData endpoint |
| SOAP | Pages and codeunits | In the product since Dynamics NAV 2009; replaced by OData V4 and due to be removed |
All three are stateless. No call keeps values from the call before it. An object goes live on the network the moment it is published, so publish only what a link needs. Microsoft logs every web service call to partner telemetry.
Every call names an environment and a company
A Business Central web address carries the environment’s name. Microsoft added that when one tenant began to hold several environments. Records sit under a company, as in /api/v2.0/companies({id})/salesQuotes({id}). So a sync finds the company first, then works inside it.
A custom API gets its own address. The page’s APIPublisher, APIGroup and APIVersion properties become part of it: /api/<API publisher>/<API group>/<API version>/companies(<company id>)/....
Start with the API Overview page inside Business Central. It lists every API page, API query and API codeunit in that environment. If your firewall filters traffic, Microsoft notes you may have to safelist its IP addresses.
A sync that runs with nobody signed in uses service-to-service sign-in. That is the OAuth 2.0 client credentials flow.
API v2.0 runs business steps, not only reads and writes
Several documents in API v2.0 carry bound actions. A bound action is a call that runs a business step inside Business Central. Each one answers HTTP 204, with no content.
Scroll the table sideways to see every column.
| Record | Bound actions | What the step does |
|---|---|---|
| salesQuote | send, makeOrder, makeInvoice | Sends the quote, or turns it into an order or an invoice |
| salesOrder | shipAndInvoice | Ships and invoices the order |
| purchaseOrder | receiveAndInvoice | Receives and invoices the order |
| purchaseInvoice | post | Posts the invoice |
Posting is its own call, so a link can save a purchase invoice and leave the post action to a person in finance.
The company record also links to report data, such as aged receivables. A purchase order record links to its document attachments.
Build a custom API when a field is missing
API v2.0 takes no extra fields. Microsoft’s answer is a custom API: an AL page with PageType set to API. Its walkthrough sets these rules:
- Key it on one GUID field, such as SystemId. Microsoft says Power Automate and Power Apps may not work with the API otherwise.
- Use Enums, not Options, for fields with a fixed list of values.
- Block what a link should not do. InsertAllowed, ModifyAllowed and DeleteAllowed turn off create, update and delete.
A custom API can also feed the Dataverse virtual tables described below.
Calls out of Business Central need an admin’s yes
AL code calls other systems through the HttpClient data type. Microsoft blocks those outbound calls by default. An admin must turn on Allow HttpClient Requests for each extension, on its Extension Settings page. That goes for library apps too.
If the setting is off, the call never leaves Business Central. The user sees a message that the request was blocked by the runtime to prevent accidental use of production services. In Business Central online, the reply to one call can be up to 150 MiB.
Dataverse links: virtual tables and business events
Dataverse is the data platform that Microsoft’s CRM apps, such as Sales and Customer Service, run on. Business Central reaches it in two ways.
Virtual tables. Power Apps can create, read, update and delete Business Central records through Dataverse. The data stays in Business Central. Custom APIs can become virtual tables too. Microsoft lists limits: no attachments or images yet, and no charts yet. Your Dataverse environment must sit in the same Microsoft Entra tenant as Business Central online.
Business events, in preview. They notify outside systems when something happens in Business Central. Microsoft names non-Microsoft warehouse, fulfillment and e-invoicing services as systems that can react. From version 22.2, a catalog of sample events is built in. Users who subscribe need the Ext. Events Subscr permission set. The Power Automate connector has a trigger that starts a flow when a business event occurs.
Webhooks are the other way to hear about changes. A webhook subscription runs out after three days unless you renew it.
Power Automate, Power BI and Excel need no custom code
Microsoft’s own tools cover many small jobs.
- Power Automate. A flow on the “For a selected record (V3)” trigger shows up in Business Central’s Automate menu. A user runs it on the record in front of them. Other triggers fire on approval requests, such as a purchase document approval.
- Power BI. Microsoft recommends exposing report data as an API. Since 2021 release wave 2, Power BI reads only OData V4, and OData V4 does not export data from more than one company. Codeunits are not offered as OData sources.
- Excel. Open in Excel exports a list, but changes stay in the file. Edit in Excel sends changes back to Business Central. It needs the Business Central add-in in Excel.
E-invoices run through the E-Document Core app
Microsoft’s E-Document Core app handles e-documents such as invoices and receipts, going out and coming in. Microsoft aims it at countries whose rules call for special e-document handling. It sends and receives through outside access points.
For EDI order messages, the Microsoft pages we read on 19 November 2026 describe e-documents for invoicing only. None of them describes a module for X12 or EDIFACT order messages with trading partners. For those, an EDI provider or a custom build sits between Business Central and the partner. It works through the API and business events above.
Dynamics NAV links need a plan before 2028
Dynamics NAV 2018 leaves extended support on January 11, 2028, and left mainstream support on January 10, 2023, by Microsoft’s lifecycle page, which gives its dates in Pacific time.
Microsoft’s migration FAQ rules out a direct jump. A NAV system goes to Business Central on-premises first, then to the cloud. Its links need a plan as well. SOAP has shipped since Dynamics NAV 2009. Version 29.0 (2026 release wave 2) ended SOAP endpoints on Microsoft pages, and version 30.0 (2027 release wave 1) ends OData endpoints on them too. For an OData link to such a page, Microsoft’s answer is to copy the page’s source code into an extension of your own. So rebuild a NAV-era page link on API v2.0 or a custom API instead.
Two pages go deeper: MCP and Shopify
Business Central MCP server
Microsoft hosts the Business Central MCP server at mcp.businesscentral.dynamics.com. MCP, the Model Context Protocol, is how an AI assistant calls it. Beyond Microsoft’s own tools, its docs list MCP Inspector, Claude and ChatGPT as clients that comply with the protocol. Such a client must register its own app first. Microsoft plans charges for the MCP tools, with pricing to follow in a later update. Business Central MCP server covers the tools, the sign-in and the setup.
Business Central and Shopify
Microsoft’s Shopify Connector links one or more Shopify stores to Business Central. Its testing advice notes that one store can connect from several environments or companies. Microsoft advises against pairing a Shopify sandbox store with Business Central production for tests. In that setup the connector can create or change items and customers, and its orders and invoices are hard to undo. Each user of the connector needs the SHPFY ADMIN permission set. Business Central Shopify integration covers the sync settings and the order flow.
Limits every Business Central sync must respect
Scroll the table sideways to see every column.
| Limit | Microsoft’s figure |
|---|---|
| OData and API requests, per user | 6,000 per 5-minute sliding window; then HTTP 429 |
| OData requests worked on at once, per user | 5; the rest queue, and a queued call times out after 8 minutes with HTTP 503 |
| OData connections and queue, per user | 100 open at once and 95 waiting, then HTTP 429 |
| Size of one request body | 350 MB |
| SOAP requests, per user | 6,000 in a 5-minute window, then HTTP 429; Microsoft plans to cut SOAP throughput |
| Reply to one outbound HttpClient call | 150 MiB |
| Life of a webhook subscription | Three days, unless renewed |
Microsoft warns that a link which runs every call as one user can hit these limits fast. The same goes for one service principal, the app login a sync uses. The Dynamics 365 integration page lists more of them, with the Finance and Dataverse limits beside them.
Which route fits which job
Each job below maps to the route Microsoft documents for it.
- A person runs a step on one record. A Power Automate flow on the selected-record trigger.
- Another app needs records now. API v2.0, or a custom API for missing fields.
- Another system must hear about a change. Business events in preview, or webhooks.
- Power Apps must show Business Central data. Virtual tables.
- Invoices must go out in a legal e-format. The E-Document Core app.
- An AI assistant should read or act. Microsoft’s MCP server, or an agent built for the job. See Dynamics 365 AI agents.
Our team has taken Dynamics 365 Business Central live. For a new setup, see Business Central implementation.
Questions
Does Business Central have an API?
Yes. Business Central online and on-premises both expose an API. API v2.0 is a REST API built on OData version 4. Microsoft says the APIs are on by default online, while on-premises needs a few steps to enable access first. The built-in APIs cover records such as customers, items, sales quotes and purchase orders, and they need no code. For a field they lack, a developer builds a custom API page in AL.
Can I add a custom field to the Business Central API?
Not to API v2.0 itself. Microsoft says the standard API takes no extra fields. A developer copies the code and builds a custom API page in AL, with PageType set to API. Its publisher, group and version become part of the web address. Key it on one GUID field, such as SystemId, or Power Automate and Power Apps may not work with it.
Can Business Central call an outside API?
Yes, from AL code, through the HttpClient data type. Microsoft blocks those outbound calls by default. An admin turns on Allow HttpClient Requests for each extension on the Extension Settings page, library apps included. In Business Central online, the reply to one call can be up to 150 MiB. Check that setting before go-live, or the call fails.
Is SOAP still supported in Business Central?
For now, but it is on its way out. Microsoft says SOAP is replaced by OData V4 and that SOAP support will be removed in a later release. Version 29.0, in 2026 release wave 2, stopped Microsoft pages working as SOAP endpoints, and version 30.0 in 2027 release wave 1 does the same for OData. So move a link to API v2.0 or a custom API, not to an OData page.
Can Power BI report across several Business Central companies?
Yes, through the API. Microsoft's Power BI page shows how. Turn the query for one company into a custom Power Query function that takes the company ID. Run it over a list of companies. Then merge the results with Table.Combine. A plain OData feed can't do it. Since 2021 release wave 2, Power BI reads only OData V4, and that does not export data from more than one company.
Does Business Central work with Dataverse and Power Apps?
Yes, in two ways. Virtual tables let Power Apps create, read, update and delete Business Central records, while the data stays in Business Central. Business events, still in preview, tell outside systems when something happens. Your Dataverse environment must sit in the same Microsoft Entra tenant as Business Central online. Virtual tables do not carry attachments or images yet.
Do we need an official Microsoft partner to integrate Business Central?
Not for this work. What decides an integration is a team that knows Business Central from the inside and builds on Microsoft's published APIs. Our team has taken Dynamics 365 Business Central live. You buy the licenses through a Microsoft Cloud Solution Provider, the only channel Microsoft names. We take the consulting, setup, data move, training and agent build from there.
What does Business Central offer for EDI?
For e-invoicing, Microsoft's E-Document Core app sends and receives invoices through outside access points. The Microsoft pages we read on 19 November 2026 describe no module for X12 or EDIFACT order messages with trading partners. For those, an EDI provider or a custom build sits between Business Central and the partner. It uses the API and business events.
Sources
Every source behind a figure or a vendor fact on this page, with the day we read it.
- Microsoft Learn, Compare REST APIs, OData, and SOAP web services in Business CentralRead 19 Nov 2026
- Microsoft Learn, Endpoints for the Business Central APIsRead 19 Nov 2026
- Microsoft Learn, API (v2.0) for Business CentralRead 18 Nov 2026
- Microsoft Learn, Developing a custom APIRead 19 Nov 2026
- Microsoft Learn, salesQuote resource typeRead 19 Nov 2026
- Microsoft Learn, salesOrder resource typeRead 18 Nov 2026
- Microsoft Learn, purchaseOrder resource typeRead 19 Nov 2026
- Microsoft Learn, purchaseInvoice resource typeRead 18 Nov 2026
- Microsoft Learn, company resource typeRead 19 Nov 2026
- Microsoft Learn, item resource typeRead 18 Nov 2026
- Microsoft Learn, customer resource typeRead 18 Nov 2026
- Microsoft Learn, HttpClient data typeRead 19 Nov 2026
- Microsoft Learn, Power Platform integration with Business Central via virtual tablesRead 19 Nov 2026
- Microsoft Learn, Business events on Business Central (preview)Read 19 Nov 2026
- Microsoft Learn, Business Central webhooksRead 18 Nov 2026
- Microsoft Learn, Business Central connectorRead 19 Nov 2026
- Microsoft Learn, Build Power BI reports with Business Central dataRead 19 Nov 2026
- Microsoft Learn, View and edit Business Central data in ExcelRead 19 Nov 2026
- Microsoft Learn, E-documents overviewRead 19 Nov 2026
- Microsoft Learn, Get started with the Shopify ConnectorRead 19 Nov 2026
- Microsoft Learn, Business Central MCP server overviewRead 19 Nov 2026
- Microsoft Learn, Business Central operational limitsRead 18 Nov 2026
- Microsoft Learn, Business Central deprecated features in the platformRead 18 Nov 2026
- Microsoft Learn, Service-to-service authentication in Business CentralRead 18 Nov 2026
- Microsoft Learn, FAQ about migrating to Business Central onlineRead 19 Nov 2026
- Microsoft Learn, Agents, Copilot and AI capabilities in Dynamics 365 appsRead 18 Nov 2026
- Microsoft Lifecycle, Dynamics NAV 2018Read 19 Nov 2026
Pages in this section
- Business Central MCPMicrosoft runs an official Business Central MCP server for the online version. It reads by default; admins switch on write tools per API page.
- Business Central ShopifyMicrosoft's Shopify Connector links Shopify with Business Central online: products, stock, customers, orders and payouts. It does not run on-premises.
Tell us what Business Central must talk to
Bring the systems on each side, the records that move and how fresh they must be. On the first call we look at the routes for your own systems. The first call is free.