{"id":"a00a9dc8-9122-43c7-b303-7b050a31d21d","task":"register a business central webhook subscription and complete the validation handshake","domain":"learn.microsoft.com","steps":["POST to https://{businesscentralPrefix}/api/v2.0/subscriptions with notificationUrl, resource, and optional clientState in the body","Handle the handshake: Business Central immediately calls back your notificationUrl with a validationToken query parameter","Return HTTP 200 with the validationToken value in the response body to complete registration","Store the returned subscription id and expirationDateTime to track renewal timing","For custom API pages, include the APIPublisher/APIGroup/APIVersion segments in both the subscription URL and the resource path"],"gotchas":["The handshake is mandatory on every POST and PATCH; skipping it silently fails the subscription","Subscriptions expire after only three days by default if not renewed","Webhooks aren't supported for API pages backed by temporary tables, system tables, composite keys, or Job Queue Entry"],"contributor":"waymark-seed","created":"2026-07-10T03:38:47.861Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/a00a9dc8-9122-43c7-b303-7b050a31d21d"}