learning-business-central — posts/admin-center-pte-deployment.html
index.html
admin-center-pte-deployment.html
posts / deprecations

Deploy Your PTEs with the Admin Center API Before Business Central v30

Roberto Corella September 24, 2026 Business Central · Admin Center · API

Another entry in the series on Business Central features being retired. After the one on SOAP, this time it's a change that touches almost everyone who works with extensions: uploading an app from the Extension Management page inside Business Central is going away.

The good news is that the replacement is already available and fully working. In this post we look at what exactly changes, how to upload extensions from the Admin Center, and how to automate the whole thing with the Admin Center API.

Deploying a per-tenant extension through the Business Central Admin Center API

What's going away, and when

Until now the routine was straightforward: open Business Central, go to Extension Management, choose Manage > Upload Extension, pick the .app file and you were done. Partners did it, and so did plenty of customers with their own in-house development team.

That upload option is being removed. Microsoft already shows the warning on the page itself and documents it in the deprecated features list: starting with version 30 (2027 release wave 1, April 2027), extensions can no longer be uploaded from Extension Management.

It's worth being precise about the scope. The Extension Management page itself isn't disappearing — you'll still use it to review what's installed in an environment. What goes away is the upload action.

Extension Management page in Business Central showing the deprecation warning on the upload action

Why the change? Centralizing deployment in the Admin Center gives administrators a single control point over what gets installed in each environment, when it gets installed, and who is allowed to do it, instead of depending on whoever happens to have access inside the application.

Uploading extensions from the Admin Center

The new path is the Business Central Admin Center, and you'll need administration permissions on the tenant to get there.

Uploading and installing a per-tenant extension from the Business Central Admin Center

What makes this more than a straight replacement is the control it adds over when the installation happens. You can choose to:

The sync mode option is still there too, exactly as it worked in Extension Management.

During the transition period both methods work side by side. My recommendation is to start using the Admin Center now, so April 2027 doesn't catch you with processes that still need rewriting.

Automating deployment with the Admin Center API

If you manage a lot of customers or a lot of environments, uploading by hand through the portal doesn't scale. That's where the Admin Center API comes in: a documented REST API for managing environments and apps programmatically. Among the recent additions is exactly what we need here — uploading and managing per-tenant extensions.

That opens up several options:

A worked example: deployments from inside Business Central

In the video I walk through an extension of my own that turns Business Central into a deployment console for a partner:

Once the operation finishes, refreshing the extension list shows the new PTE. And if you open the environment and go to Extension Management, there it is: the page is still perfectly useful for reviewing, just not for uploading.

The practical takeaway

Stay tuned for the next entry, where we keep going through the features that are on their way out of Business Central.

Watch the full walkthrough — the video below shows an example.

Video walkthrough

If you found this content useful, you can buy me a coffee — it helps me keep writing and recording. Thank you!
main github.com/RCORELLA/LearningBusinessCentral