PendingExternalUserProfile.ReadWrite.All

Permission Details

Application Permission

Read and write all pending external user profiles

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

Permission ID: 8363c2b8-6ff7-420b-9966-c5884c2d48bc

Delegated Permission

Read and write pending external user profiles

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

Permission ID: 93a1fb28-c908-4826-904e-0c74ad352b73

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}`
POST `/directory/pendingExternalUserProfiles`
PATCH `/directory/pendingExternalUserProfiles/{id}`
DELETE `/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
`New-MgBetaDirectoryPendingExternalUserProfile` /directory/pendingExternalUserProfiles Create pendingExternalUserProfile
`Remove-MgBetaDirectoryPendingExternalUserProfile` /directory/pendingExternalUserProfiles/{id} Delete pendingExternalUserProfile
`Update-MgBetaDirectoryPendingExternalUserProfile` /directory/pendingExternalUserProfiles/{id} Update pendingExternalUserProfile

Code Examples

C# / .NET SDK

Create pendingExternalUserProfile

View official example on Microsoft Learn

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

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new PendingExternalUserProfile
{
	PhoneNumber = "+15555555555",
	DisplayName = "Bob Henry",
};

// 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.PostAsync(requestBody);

JavaScript

Create pendingExternalUserProfile

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

const pendingExternalUserProfile = {
    phoneNumber: '+15555555555',
    displayName: 'Bob Henry'
};

await client.api('/directory/pendingExternalUserProfiles')
	.version('beta')
	.post(pendingExternalUserProfile);

PowerShell

Create pendingExternalUserProfile

View official example on Microsoft Learn

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

$params = @{
	phoneNumber = "+15555555555"
	displayName = "Bob Henry"
}

New-MgBetaDirectoryPendingExternalUserProfile -BodyParameter $params

Python

Create 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
from msgraph_beta.generated.models.pending_external_user_profile import PendingExternalUserProfile
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = PendingExternalUserProfile(
	phone_number = "+15555555555",
	display_name = "Bob Henry",
)

result = await graph_client.directory.pending_external_user_profiles.post(request_body)

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.ReadWrite.All

4

Grant Admin Consent

Application permissions always require admin consent.