PendingExternalUserProfile.Read.All

Permission Details

Application Permission

Read all pending external user profiles

Allows the app to read available properties of pending external user profiles, without a signed-in user.

Permission ID: bdfb26d9-bb36-49be-9b4c-b8cbf4b05808

Delegated Permission

Read pending external user profiles

Allows the app to read available properties of pending external user profiles, on behalf of the signed-in user.

Permission ID: d88fd3fb-53d3-4c1c-8c39-787fcac2ed7a

Properties

Microsoft Graph beta exact-category-docs

Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Property	Type	Description
`address`	`physicalOfficeAddress`	The office address of the pending external user profile. Inherited from externalProfile.
`createdBy`	`String`Nullable	The object ID of the user or principal who created the pending external user profile or invited the external user. Inherited from externalProfile. Read-only. Not nullable.
`createdDateTime`	`DateTimeOffset`Nullable	Date and time when this pending external user profile was created. Inherited from externalProfile. Not nullable. Read-only.
`companyName`	`String`Nullable	The company name of the pending external user profile. Inherited from externalProfile. Supports the $filter (eq, startswith) query parameter.
`deletedDateTime`	`DateTimeOffset`Nullable	Date and time when the pending external user profile was deleted. Always null when the object isn't deleted. Inherited from externalProfile.
`department`	`String`Nullable	The department of the pending external user profile. Inherited from externalProfile.
`displayName`	`String`	The display name of the pending external user profile. Inherited from externalProfile.
`id`	`String`	The unique identifier for the pending external user profile. Not nullable. Read-only.
`isDiscoverable`	`Boolean`Nullable	Represents whether the pending external user profile is discoverable in the directory. When true, this external profile shows up in Teams search. Inherited from externalProfile.
`isEnabled`	`Boolean`Nullable	Represents whether the pending external user profile is enabled in the directory. Inherited from externalProfile.
`jobTitle`	`String`Nullable	The job title of the external user profile. Inherited from externalProfile.
`phoneNumber`	`String`Nullable	The phone number of the pending external user profile. Must be in E.164 format. Inherited from externalProfile.
`supervisorId`	`String`Nullable	The object ID of the supervisor of the pending external user profile. Inherited from externalProfile. Supports the $filter (eq, startswith) query parameter.

JSON Representation

Microsoft Graph beta exact-category-docs

JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

JSON representation

{
  "@odata.type": "#microsoft.graph.pendingExternalUserProfile",
  "id": "String (identifier)",
  "deletedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "createdBy": "String",
  "companyName": "String",
  "displayName": "String",
  "jobTitle": "String",
  "isDiscoverable": "Boolean",
  "isEnabled": "Boolean",
  "department": "String",
  "phoneNumber": "String",
  "address": {
    "@odata.type": "microsoft.graph.physicalOfficeAddress"
  },
  "supervisorId": "String"
}

Relationships

Relationships metadata is not available for this permission mapping.

View resource documentation

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

No API methods available for this version.

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/directory/pendingExternalUserProfiles/{id}`

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgBetaDirectoryPendingExternalUserProfile` /directory/pendingExternalUserProfiles/{id} Get pendingExternalUserProfile
`Get-MgBetaDirectoryPendingExternalUserProfile` /directory/pendingExternalUserProfiles/{id} List pendingExternalUserProfiles

Code Examples

C# / .NET SDK

Get pendingExternalUserProfile

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Directory.PendingExternalUserProfiles["{pendingExternalUserProfile-id}"].GetAsync();

JavaScript

Get pendingExternalUserProfile

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

let pendingExternalUserProfile = await client.api('/directory/pendingExternalUserProfiles/{id}')
	.version('beta')
	.get();

PowerShell

Get pendingExternalUserProfile

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Beta.Identity.DirectoryManagement

Get-MgBetaDirectoryPendingExternalUserProfile -PendingExternalUserProfileId $pendingExternalUserProfileId

Python

Get pendingExternalUserProfile

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.directory.pending_external_user_profiles.by_pending_external_user_profile_id('pendingExternalUserProfile-id').get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for PendingExternalUserProfile.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.