Configure custom extensions for PIM role activation
In brief
The article no longer labels custom extensions for PIM role activation as preview, and removes the preview legal notice and beta endpoint note.
What Entra admins need to know
No administrator action is stated.
This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.
Documentation change
The comparison below shows only the changed extract. Use the full-page view for complete context.
Configure custom extensions for Privileged Identity Management role activation (Preview)
Custom extensions in Microsoft Entra Privileged Identity Management (PIM) enable organizations to integrate custom business logic into the role activation process. These extensions are implemented as REST APIs that PIM calls during policy evaluation. The custom extension evaluates the activation request and returns a decision to PIM indicating whether the activation should be allowed or denied.
:::image type="content" source="media/privileged-identity-management-custom-extensions/custom-extension-architecture-flow.png" alt-text="Diagram that shows the PIM custom extension architecture flow from activation request through policy evaluation to the custom extension API and external services." lightbox="media/privileged-identity-management-custom-extensions/custom-extension-architecture-flow.png":::
License requirements
Using custom extensions with PIM requires an active Microsoft Entra ID Governance or Microsoft Entra Suite license. Microsoft Entra ID P2 alone doesn't include PIM custom extensions. For more information, see Microsoft Entra ID Governance licensing fundamentals.
An assignment of at least the Privileged Role Administrator role.
A REST API endpoint that accepts HTTP POST requests and returns evaluation responses in the format PIM expects. The API can be built in any language and hosted on any platform.
A Microsoft Entra ID application registration to secure communication between PIM and your custom extension endpoint.
The
Microsoft Graph APIbetaendpoint is required because this feature is in preview.Thefollowing delegated Microsoft Graph permissions, depending on the operation:| Operation | Permission (least privileged) |
@@ -1,5 +1,5 @@ ----title: Configure custom extensions for PIM role activation (Preview)+title: Configure custom extensions for PIM role activation description: Learn how to configure custom extensions in Microsoft Entra Privileged Identity Management (PIM) to integrate custom business logic into role activation workflows. ms.topic: how-to ms.date: 10/12/2026@@ -10,7 +10,7 @@ ai-usage: ai-assisted --- -# Configure custom extensions for Privileged Identity Management role activation (Preview)+# Configure custom extensions for Privileged Identity Management role activation Custom extensions in Microsoft Entra Privileged Identity Management (PIM) enable organizations to integrate custom business logic into the role activation process. These extensions are implemented as REST APIs that PIM calls during policy evaluation. The custom extension evaluates the activation request and returns a decision to PIM indicating whether the activation should be allowed or denied. @@ -27,9 +27,6 @@ Custom extensions support PIM for Groups, PIM for Microsoft Entra roles, and PIM :::image type="content" source="media/privileged-identity-management-custom-extensions/custom-extension-architecture-flow.png" alt-text="Diagram that shows the PIM custom extension architecture flow from activation request through policy evaluation to the custom extension API and external services." lightbox="media/privileged-identity-management-custom-extensions/custom-extension-architecture-flow.png"::: -> [!IMPORTANT]-> Custom extensions for PIM are in preview. See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.- ## License requirements Using custom extensions with PIM requires an active Microsoft Entra ID Governance or Microsoft Entra Suite license. Microsoft Entra ID P2 alone doesn't include PIM custom extensions. For more information, see [Microsoft Entra ID Governance licensing fundamentals](~/id-governance/licensing-fundamentals.md).@@ -39,7 +36,6 @@ Using custom extensions with PIM requires an active Microsoft Entra ID Governanc - An assignment of at least the **Privileged Role Administrator** role. - A REST API endpoint that accepts HTTP POST requests and returns evaluation responses in the format PIM expects. The API can be built in any language and hosted on any platform. - A Microsoft Entra ID application registration to secure communication between PIM and your custom extension endpoint.-- The Microsoft Graph API `beta` endpoint is required because this feature is in preview. - The following delegated Microsoft Graph permissions, depending on the operation: | Operation | Permission (least privileged) | 