Skip to main content
Connector guides

Connect Microsoft Power Platform Admin

Microsoft Power Platform Admin is the administration side of Power Apps, Power Automate and Copilot Studio. StackJack connects an AI assistant to the services behind the Power Platform admin center,…

Written By Christopher Scaminaci

Last updated 5 days ago

Microsoft Power Platform Admin is the administration side of Power Apps, Power Automate and Copilot Studio. StackJack connects an AI assistant to the services behind the Power Platform admin center, in your own Microsoft directory or in a customer's directory named on each call. It is separate from the Microsoft Graph connector, and it is not the maker side of Power Platform (the apps, flows and agents themselves).

Connecting Power Platform Admin to StackJack gives your AI assistant a family of pp_ MCP tools. MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:

  • Read environments - the environments of a directory, with their type, region and state, or one environment by name; the backups of an environment, the lifecycle operations it ran, the environments a copy or restore can overwrite, the places and templates a new environment can use, and the environment's management settings (the Copilot Studio governance features, among others)
  • Read data policies - the data loss prevention rules that decide which connectors Power Apps, Power Automate and Copilot Studio agents may use, with each policy's connector classification, its custom connector URL patterns and the tenant error message
  • Read billing policies - the pay-as-you-go plans that bill metered services such as Copilot Chat and Copilot Studio to an Azure subscription, and the environments linked to each
  • Administer (on Pro plans) - provision, copy, back up, restore, reset, delete and recover environments, group them into environment groups, turn managed governance on or off for an environment, and change its management settings; create, change and delete data policies and their connector and URL pattern rules, re-check existing connections after a policy change; and create, rename, delete and link billing policies to environments

Copilot Studio agent connectors are data policy connectors. A policy classifies the connector that lets an agent chat without sign-in, or call an HTTP endpoint, as Business, Non-business or Blocked like any other connector, so the data policy tools are how an AI assistant reads and sets those limits.

Disaster recovery, changing an environment's SKU and linking Dataverse are not typed tools. The raw tools reach them.

How StackJack authenticates to Power Platform

There are no keys to create. You sign in with Microsoft, and StackJack then acts as you. Power Platform checks your own role on every call: if your role lets you do something in the Power Platform admin center, it lets you do it here, and the reverse.

Connect it in StackJack

  1. Open Connectors, then Microsoft Power Platform Admin.
  2. Click Connect with Microsoft and sign in with the work account you use for the Power Platform admin center. This step asks only for your profile, so it works whether or not your own directory uses Power Platform.
  3. Under Authorize a directory, enter a tenant ID or a verified domain and click Generate link, then Generate Power Apps link. Send both links to an administrator in that directory: a Global Administrator, Application Administrator or Cloud Application Administrator approves each once. Do this for each customer, and for your own directory if you use Power Platform there.

Team members connect individually, so each person's changes appear under their own name in Power Platform.

Reaching a customer

Every tool takes an optional entraTenant: the customer's tenant ID or a verified domain such as contoso.onmicrosoft.com. Without it, the call goes to your own directory. To reach a customer, three things must be true:

  1. Delegated access. You hold a GDAP relationship with that customer, or an account in their directory.
  2. A Power Platform role there. For GDAP, your access assignment must include Power Platform Administrator, which Microsoft lists as supported for every menu item of the Power Platform admin center. A read-only role reads and cannot change a policy.
  3. The consents above. There are two, one for the Power Platform API and one for the Power Apps Service, and a directory needs both. They are separate from the Microsoft Graph, Azure, Defender, Exchange Online and Teams consents, so a customer you already authorized for those still needs these. A directory with no Power Platform service cannot grant them.

A few Microsoft routes (a data policy's connector rules, URL patterns, error message and connector blocking policies) carry the directory's tenant ID in the address. You do not have to know it: StackJack reads it from the access token it gets for that directory, so a domain name in entraTenant works like everywhere else. If Microsoft's token carries no directory ID, the call is refused before anything is sent, with a sentence that says so.

Using your own Microsoft application

By default StackJack connects through its own Microsoft application. To consent to an application your organization owns, register a multitenant Entra application that carries StackJack's redirect URLs and the Power Platform API and Power Apps Service delegated permissions, paste its client ID and secret under Advanced on the card, then connect. The Microsoft Graph page describes the provisioning script. Customers then consent to your application instead.

When you use your own application, the card also offers Authorize all customers, the same one-run consent that the Microsoft Graph, Azure, Defender, Exchange Online and Teams cards offer. It consents both Power Platform resources in every customer you manage through GDAP, skips a customer that has no Power Platform service, and runs as you through your own Power Platform Admin sign-in.

When something goes wrong

What you seeWhat to do
Microsoft stops the consent with AADSTS650052The directory does not have a service the link asks for. The page that opens after the sign-in says Consent was not granted and shows this code, and Microsoft's message names the service by its application ID. Each link from StackJack asks only for its own connector's permissions, so the service is usually that connector's own, and the directory cannot use that connector (for example, a directory with no Defender). The Purview content search link is the one exception: it asks for every permission on the app, so the directory needs every service the app lists. If the ID is 4990cffe-04e8-4e8b-808a-1175604b879f, it is the Microsoft Partner permission (user_impersonation) on the app. With StackJack's app or your own app, make a fresh consent link in StackJack and send that link. Only the Purview content search link on your own app still needs the removal: remove Microsoft Partner from the API permissions of your app registration in Microsoft Entra, or download the current provisioning script again and run it with -AppId set to your app's application (client) ID. A re-run adds a new client secret, replaces the permission list with the tier you pass (Full if you pass none), and replaces the display name with -DisplayName, so pass the app's current name. Do not remove Microsoft Partner Center; it is a different permission. To consent your own customers without a link, use Authorize all customers on the card. If the message names another service, contact support.

What is worth knowing before you start

This connector is new

The data policy routes come from the Microsoft Power Platform administration PowerShell module and are not published as a REST reference, the environment management family is labelled preview by Microsoft, a few of its routes are inferred from their documented neighbours, and nothing has proven that a delegated StackJack token passes every Power Platform admin host. If a tool answers with a refusal you did not expect, run pp_list_environments for that directory. The answer shows whether the sign-in, your role, the consent or the service said no.

Writes change real settings at once

Changing or deleting a data policy takes effect in the customer's tenant. A policy can block the connectors that an organization's flows and agents depend on, and a re-check of existing connections disables every connection that now violates a policy. A billing policy decides which Azure subscription is charged for metered use. Every write is on the Pro tier, is marked destructive and asks for approval before it runs.

Environment changes can overwrite or remove an environment

Copy and restore overwrite the target environment: everything in it is replaced, and the change cannot be undone except by restoring a backup of the target. Reset removes an environment's data and apps. Delete removes an environment with its apps, flows, agents and data; it can be recovered for a limited time (seven days, or 28 for a production environment with Dynamics 365 apps). Create a manual backup first. Provisioning an environment uses tenant capacity.

Copy, restore, delete, recover and reset take validateOnly: set it to true and Microsoft checks the request and answers what would fail, without changing anything. These operations answer 202 with no body; read the progress with pp_list_environment_operations and pp_get_environment_operation.

Turning managed governance off stops everything that depends on it, among them the Copilot Studio governance settings, sharing limits and environment group rules, so check that none of the Managed Environments capabilities is in use first. Changing the management settings (a Copilot Studio governance feature such as connected agents or the code interpreter) takes effect for makers and agents in the environment at once; the update sends only the fields you give.

A policy is replaced as a whole

A data policy update sends the body you give it. Read the policy first with pp_get_data_policy, change what you need, and send the result, so a setting you did not mean to touch keeps its value. A billing policy update changes only its name and its status.

Two billing surfaces

The billing policies this connector manages are the ones of the Power Platform admin center, linked to environments. The Microsoft 365 admin center has a separate set of billing policies for Copilot with a budget and a user group. This connector does not write those.

The raw tools

pp_raw_get reads, and pp_raw_request writes, any path under a reviewed root on one of three hosts: api (the Power Platform API), bap (the admin and governance service) or apps (the Power Apps service). Governance rule-based policies, currency allocations, disaster recovery and the environment management settings are reachable this way. Write directory-from-token where a path needs the directory's tenant ID. The write is on the Pro tier and marked destructive. A body that is not valid JSON is refused before anything is sent.

When Power Platform refuses a call

  • Admin consent is missing: that directory has not approved one of the two applications. Use the links on the card. Connecting again does not help.
  • Your account lacks access to that directory: the GDAP check failed. Check the tenant ID and your relationship with the customer.
  • The action is refused: your role in that directory does not include the change. Signing in again does not change it.
  • The policy is not found: check the name with the matching read tool, and check that entraTenant names the directory the policy is in.
  • Rate limited: StackJack waits as long as Power Platform asks.

Plans and limits

Reads are available on the Free tier. Every write is Pro. Business reaches the same tools as Pro and differs by monthly call quota.

See the generated Microsoft Power Platform Admin tool reference for the current inventory, plan assignment, input schemas and destructive-action labels.

Microsoft Power Platform Admin tools

pp_ · 66 tools · Free 26 · Pro 40

Environments

ToolWhat it does
pp_get_environment
Free · Read-only
Gets one Power Platform environment by its name (the id shown by pp_list_environments).
pp_list_environments
Free · Read-only
Lists the Power Platform environments of the tenant (the Business Application Platform admin API, generally available): name, display name, type, region and state; with expand, capacity and add-ons.

Environment Lifecycle

ToolWhat it does
pp_copy_environment
Pro · Destructive
DESTRUCTIVE.
pp_create_environment
Pro · Destructive
DESTRUCTIVE.
pp_create_environment_backup
Pro · Destructive
DESTRUCTIVE.
pp_delete_environment
Pro · Destructive
DESTRUCTIVE.
pp_delete_environment_backup
Pro · Destructive
DESTRUCTIVE.
pp_get_environment_operation
Free · Read-only
Gets the status of an environment lifecycle operation (a provision, copy, restore, delete, recover or reset) by its id: queued, in progress, succeeded or failed, with the per-stage progress.
pp_list_environment_backups
Free · Read-only
Lists the backups of an environment (system and manual) with their id, label, restore point and expiry.
pp_list_environment_copy_candidates
Free · Read-only
Lists the environments that a copy FROM the given source environment can overwrite (the valid targets of pp_copy_environment).
pp_list_environment_operations
Free · Read-only
Lists the lifecycle operations of one environment, newest information first as the service orders it, one page (limit, continuationToken).
pp_list_environment_restore_candidates
Free · Read-only
Lists the environments that a restore FROM the given source environment can overwrite (the valid targets).
pp_list_provisioning_currencies
Free · Read-only
Lists the currencies available for a new environment in a location.
pp_list_provisioning_languages
Free · Read-only
Lists the languages available for a new environment in a location.
pp_list_provisioning_locations
Free · Read-only
Lists the locations and macro regions where a new environment can be provisioned, and whether the tenant picks a location or a macro region.
pp_list_provisioning_templates
Free · Read-only
Lists the templates available for a new environment in a location.
pp_recover_environment
Pro · Destructive
DESTRUCTIVE.
pp_reset_environment
Pro · Destructive
DESTRUCTIVE.
pp_restore_environment
Pro · Destructive
DESTRUCTIVE.

Environment Groups

ToolWhat it does
pp_add_environment_to_group
Pro · Destructive
DESTRUCTIVE.
pp_create_environment_group
Pro · Destructive
DESTRUCTIVE.
pp_delete_environment_group
Pro · Destructive
DESTRUCTIVE.
pp_get_environment_group
Free · Read-only
Gets one environment group by its id.
pp_list_environment_groups
Free · Read-only
Lists the tenant's environment groups (a group collects environments so one set of rules and governance applies to all of them).
pp_remove_environment_from_group
Pro · Destructive
DESTRUCTIVE.
pp_update_environment_group
Pro · Destructive
DESTRUCTIVE.

Environment Governance

ToolWhat it does
pp_disable_managed_environment
Pro · Destructive
DESTRUCTIVE.
pp_enable_managed_environment
Pro · Destructive
DESTRUCTIVE.
pp_get_environment_settings
Free · Read-only
Gets the environment management settings of one environment: the Copilot Studio governance features (connected agents, code interpreter, computer use, conversation audit logging), the Power Apps, Power Pages and Customer Service Copilot features, and the IP-based storage access signature rules.
pp_update_environment_settings
Pro · Destructive
DESTRUCTIVE.

Data Policies

ToolWhat it does
pp_create_connector_blocking_policy
Pro · Destructive
DESTRUCTIVE.
pp_create_data_policy
Pro · Destructive
DESTRUCTIVE.
pp_create_data_policy_connector_configurations
Pro · Destructive
DESTRUCTIVE.
pp_create_data_policy_url_patterns
Pro · Destructive
DESTRUCTIVE.
pp_create_error_settings
Pro · Destructive
DESTRUCTIVE.
pp_create_tenant_url_patterns
Pro · Destructive
DESTRUCTIVE.
pp_delete_connector_blocking_policy
Pro · Destructive
DESTRUCTIVE.
pp_delete_data_policy
Pro · Destructive
DESTRUCTIVE.
pp_delete_data_policy_connector_configurations
Pro · Destructive
DESTRUCTIVE.
pp_delete_data_policy_url_patterns
Pro · Destructive
DESTRUCTIVE.
pp_delete_tenant_url_patterns
Pro · Destructive
DESTRUCTIVE.
pp_get_connector_blocking_policy
Free · Read-only
Gets one connector blocking policy by its id (from pp_list_connector_blocking_policies).
pp_get_data_policy
Free · Read-only
Gets one data policy by its name (a GUID from pp_list_data_policies): its connector groups, scope, default classification and etag.
pp_get_error_settings
Free · Read-only
Gets the admin contact and the Learn more link that makers see in a data policy error message.
pp_list_connector_blocking_policies
Free · Read-only
Lists the tenant's connector blocking policies (connectorEnablementConfigurations).
pp_list_data_policies
Free · Read-only
Lists the tenant's data policies (data loss prevention) with their connector groups, Business, Non-business and Blocked, including the Copilot Studio agent connectors (virtual connectors such as Chat without Microsoft Entra ID authentication in Copilot Studio, HTTP, Skills with Copilot Studio and the channel connectors).
pp_list_data_policy_connector_configurations
Free · Read-only
Lists a data policy's connector configurations (endpoint filtering: the allowed or denied endpoints of a connector such as HTTP).
pp_list_data_policy_url_patterns
Free · Read-only
Lists a data policy's custom connector URL patterns.
pp_reevaluate_connections_for_environment
Pro · Destructive
DESTRUCTIVE.
pp_reevaluate_connections_for_tenant
Pro · Destructive
DESTRUCTIVE.
pp_update_connector_blocking_policy
Pro · Destructive
DESTRUCTIVE.
pp_update_data_policy
Pro · Destructive
DESTRUCTIVE.
pp_update_data_policy_connector_configurations
Pro · Destructive
DESTRUCTIVE.
pp_update_error_settings
Pro · Destructive
DESTRUCTIVE.

Billing Policies

ToolWhat it does
pp_add_billing_policy_environments
Pro · Destructive
DESTRUCTIVE.
pp_create_billing_policy
Pro · Destructive
DESTRUCTIVE.
pp_delete_billing_policy
Pro · Destructive
DESTRUCTIVE.
pp_get_billing_policy
Free · Read-only
Gets one billing policy by its id: name, status, region and the Azure subscription and resource group it bills.
pp_get_environment_billing_policy
Free · Read-only
Gets the billing policy linked to one environment, if any.
pp_list_billing_policies
Free · Read-only
Lists the tenant's billing policies (pay-as-you-go plans that bill metered services, such as Microsoft 365 Copilot Chat and Copilot Studio, to an Azure subscription).
pp_list_billing_policy_environments
Free · Read-only
Lists the environments linked to a billing policy.
pp_refresh_billing_policy_provisioning_status
Pro · Destructive
DESTRUCTIVE.
pp_remove_billing_policy_environments
Pro · Destructive
DESTRUCTIVE.
pp_update_billing_policy
Pro · Destructive
DESTRUCTIVE.

Raw Requests

ToolWhat it does
pp_raw_get
Free · Read-only
Reads any path on a Power Platform admin host that the typed pp_ tools do not cover, for example environment groups, governance rule-based policies, currency allocations or a single environment's details.
pp_raw_request
Pro · Destructive
DESTRUCTIVE.