Dynamics 365 Business Central 2025 Wave 1 release: the state of SOAP deprecation.

I think that many of you know that quite a long time ago Microsoft raised an alert saying that exposing Dynamics 365 Business Central UI pages as SOAP endpoints (via the Web Services page) will be deprecated in the future. This should not be a news for you…

Starting from Dynamics 365 Business Central 2025 Wave 1 release (version 26) the deprecation of UI pages exposed as SOAP web services will start, but in a really soft way.

With version 26, the possibility to expose a Microsoft page as SOAP endpoint will be disabled by default. If really needed, you will still be able to re-enable this capability by using the Feature: Disable SOAP web services on Microsoft UI pages key in Feature Management:

Please remember that in Dynamics 365 Business Central version 29 the possibility to expose a Microsoft page as SOAP endpoint will be removed forever.

If you’re still using custom UI pages exposed as SOAP endpoints, this will continue to work (but please don’t do that and move to OData).

With Dynamics 365 Business Central version 26, you can use the new RT0053 telemetry signal to discover tenants that uses deprecated Microsoft UI pageds exposed as SOAP endpoints. Here is a KQL query to do so:

traces
| where timestamp > ago(30d) // Last 30 days, change as needed
| where customDimensions.eventId == "RT0053"
| project timestamp
// in which environment the deprecated endpoint was called
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
// in which object
, alObjectId = customDimensions.alObjectId
, alObjectName = customDimensions.alObjectName
, alObjectType = customDimensions.alObjectType
// Information about the endpoint
, category = customDimensions.category // API, ODataV3, ODataV4, or SOAP
, endpoint = customDimensions.endpoint // URI
// what is the issue?
, depricationMessage = customDimensions.depricationMessage 

Starting from Dynamics 365 Business Central 2025 Wave 1 release (version 26) you will also start receiving a warning if you expose a Microsoft UI page as an OData endpoint via the web service page. Starting from Dynamics 365 Business Central version 30, this will be no longer possible.

Existing custom UI pages exposed as OData endpoint will continue to work with version 26 (no warnings), but you should move to API as soon as possible.

Original Post https://demiliani.com/2025/04/07/dynamics-365-business-central-2025-wave-1-release-the-state-of-soap-deprecation/