Microsoft Dynamics 365 Business Central · AsyncAPI Specification

Microsoft Dynamics 365 Business Central Webhooks Docs

Version

View Spec View on GitHub ERPCloud ERPFinanceAccountingSupply ChainSmall BusinessMid-MarketMicrosoft Dynamics 365AsyncAPIEvents

AsyncAPI Specification

Raw ↑
name: Microsoft Dynamics 365 Business Central webhooks
generated: '2026-11-12'
method: searched
source: https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/dynamics-subscriptions
subscription:
  create: POST https://{businesscentralPrefix}/api/v2.0/subscriptions
  renew: PATCH https://{businesscentralPrefix}/api/v2.0/subscriptions({id})
  custom_api_path: api/<APIPublisher>/<APIGroup>/<APIVersion>/subscriptions
  handshake: Business Central issues a request to the notificationUrl with a validationToken query parameter; the subscriber must return validationToken in the body with 200 (on create and renew).
  expiry: Subscriptions expire after three days, if not renewed before.
verification:
  mechanism: clientState
  description: clientState is included in the body of a webhook notification and can be used as an opaque token; a shared secret, enabling the subscriber to verify notifications.
  signature_header: null
delivery:
  batching: Each notification sent to the subscriber (notificationUrl) can contain multiple notifications from different subscriptions.
  delay: By default, the system waits 30 seconds after the first change to an entity before it sends the notification.
  collection_threshold: During the 30-second delay, if more than a 1,000 records are changed, a single collection notification is sent
events:
- changeType: created
- changeType: updated
- changeType: deleted
- changeType: collection
  description: Business Central sends a notification that many records are created or changed.

Work with this as data

Every AsyncAPI spec here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for asyncapi

4 MCP tools reach this
  • find_asyncapisBrowse and filter every AsyncAPI spec in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This AsyncAPI spec
curl "https://apis.io/api/v1/asyncapis/microsoft-dynamics-365-business-central-webhooks-docs"
All asyncapi
curl "https://apis.io/api/v1/asyncapis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.