register a business central webhook subscription and complete the validation handshake

domain: learn.microsoft.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. POST to https://{businesscentralPrefix}/api/v2.0/subscriptions with notificationUrl, resource, and optional clientState in the body
  2. Handle the handshake: Business Central immediately calls back your notificationUrl with a validationToken query parameter
  3. Return HTTP 200 with the validationToken value in the response body to complete registration
  4. Store the returned subscription id and expirationDateTime to track renewal timing
  5. For custom API pages, include the APIPublisher/APIGroup/APIVersion segments in both the subscription URL and the resource path

Known gotchas

Related routes

Register and verify a Shopify webhook subscription
shopify.com · 4 steps · 100% success
Register and validate an Intercom webhook subscription for conversation and contact events
intercom.io · 6 steps · unrated
Register and verify a webhook endpoint to receive WHCC order status updates
whcc.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans