ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

User.ReadWrite

Export JSON
Export CSV
Copy URL
Print
Delegated Read/Write User Scope

Allows the app to read your profile. It also allows the app to update your profile information on your behalf.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission User consent allowed

Read and write access to user profile

Allows the app to read your profile. It also allows the app to update your profile information on your behalf.

User sees: Allows the app to read your profile, and discover your group membership, reports and manager. It also allows the app to update your profile information on your behalf.
Permission ID: b4e74841-8e56-480b-be8b-910348b18b4c

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
aboutMe StringNullable A freeform text entry field for the user to describe themselves. Returned only on $select.
accountEnabled BooleanNullable true if the account is enabled; otherwise, false. This property is required when a user is created. , , Returned only on $select. Supports $filter (eq, ne, not, and in).
ageGroup ageGroupNullable Sets the age group of the user. Allowed values: null, Minor, NotAdult, and Adult. For more information, see legal age group property definitions. , , Returned only on $select. Supports $filter (eq, ne, not, and in).
assignedLicenses assignedLicense collection The licenses that are assigned to the user, including inherited (group-based) licenses. This property doesn't differentiate between directly assigned and inherited licenses. Use the licenseAssignmentStates property to identify the directly assigned and inherited licenses. Not nullable. Returned only on $select. Supports $filter (eq, not, /$count eq 0, /$count ne 0).
assignedPlans assignedPlan collection The plans that are assigned to the user. Read-only. Not nullable. , , Returned only on $select. Supports $filter (eq and not).
birthday DateTimeOffset The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014, is 2014-01-01T00:00:00Z. , , Returned only on $select.
businessPhones String collection The telephone numbers for the user. NOTE: Although it's a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. , , Returned by default. Supports $filter (eq, not, ge, le, startsWith).
city StringNullable The city where the user is located. Maximum length is 128 characters. , , Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).
companyName StringNullable The name of the company that the user is associated with. This property can be useful for describing the company that a guest comes from. The maximum length is 64 characters., , Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).
consentProvidedForMinor consentProvidedForMinorNullable Sets whether consent was obtained for minors. Allowed values: null, Granted, Denied, and NotRequired. For more information, see legal age group property definitions. , , Returned only on $select. Supports $filter (eq, ne, not, and in).
country StringNullable The country or region where the user is located; for example, US or UK. Maximum length is 128 characters. , , Returned only on $select. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).
createdDateTime DateTimeOffsetNullable The date and time the user was created, in ISO 8601 format and UTC. The value can't be modified and is automatically populated when the entity is created. Nullable. For on-premises users, the value represents when they were first created in Microsoft Entra ID. Property is null for some users created before June 2018 and on-premises users that were synced to Microsoft Entra ID before June 2018. Read-only. , , Returned only on $select. Supports $filter (eq, ne, not , ge, le, in).
creationType StringNullable Indicates whether the user account was created through one of the following methods: , <ul<liAs a regular school or work account (null). <liAs an external account (Invitation). <liAs a local account for an Azure Active Directory B2C tenant (LocalAccount). <liThrough self-service sign-up by an internal user using email verification (EmailVerified). <liThrough self-service sign-up by a guest signing up through a link that is part of a user flow (SelfServiceSignUp).</ul , Read-only., Returned only on $select. Supports $filter (eq, ne, not, in).
customSecurityAttributes customSecurityAttributeValue An open complex type that holds the value of a custom security attribute that is assigned to a directory object. Nullable. , , Returned only on $select. Supports $filter (eq, ne, not, startsWith). The filter value is case-sensitive. , <liTo read this property, the calling app must be assigned the CustomSecAttributeAssignment.Read.All permission. To write this property, the calling app must be assigned the CustomSecAttributeAssignment.ReadWrite.All permissions. <liTo read or write this property in delegated scenarios, the admin must be assigned the Attribute Assignment Administrator role.
deletedDateTime DateTimeOffsetNullable The date and time the user was deleted. , , Returned only on $select. Supports $filter (eq, ne, not, ge, le, in).

Showing 15 of 136 properties.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation 
{
  "aboutMe": "String",
  "accountEnabled": true,
  "ageGroup": "String",
  "assignedLicenses": [
    {
      "@odata.type": "microsoft.graph.assignedLicense"
    }
  ],
  "assignedPlans": [
    {
      "@odata.type": "microsoft.graph.assignedPlan"
    }
  ],
  "birthday": "String (timestamp)",
  "businessPhones": [
    "String"
  ],
  "city": "String",
  "companyName": "String",
  "consentProvidedForMinor": "String",
  "country": "String",
  "createdDateTime": "String (timestamp)",
  "creationType": "String",
  "customSecurityAttributes": {
    "@odata.type": "microsoft.graph.customSecurityAttributeValue"
  },
  "department": "String",
  "displayName": "String",
  "employeeHireDate": "2020-01-01T00:00:00Z",
  "employeeId": "String",
  "employeeOrgData": {
    "@odata.type": "microsoft.graph.employeeOrgData"
  },
  "employeeType": "String",
  "faxNumber": "String",
  "givenName": "String",
  "hireDate": "String (timestamp)",
  "id": "String (identifier)",
  "identities": [
    {
      "@odata.type": "microsoft.graph.objectIdentity"
    }
  ],
  "imAddresses": [
    "String"
  ],
  "interests": [
    "String"
  ],
  "isManagementRestricted": "Boolean",
  "isResourceAccount": false,
  "jobTitle": "String",
  "legalAgeGroupClassification": "String",
  "licenseAssignmentStates": [
    {
      "@odata.type": "microsoft.graph.licenseAssignmentState"
    }
  ],
  "lastPasswordChangeDateTime": "String (timestamp)",
  "mail": "String",
  "mailboxSettings": {
    "@odata.type": "microsoft.graph.mailboxSettings"
  },
  "mailNickname": "String",
  "mobilePhone": "String",
  "mySite": "String",
  "officeLocation": "String",
  "onPremisesDistinguishedName": "String",
  "onPremisesDomainName": "String",
  "onPremisesExtensionAttributes": {
    "@odata.type": "microsoft.graph.onPremisesExtensionAttributes"
  },
  "onPremisesImmutableId": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [
    {
      "@odata.type": "microsoft.graph.onPremisesProvisioningError"
    }
  ],
  "onPremisesSamAccountName": "String",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": true,
  "onPremisesUserPrincipalName": "String",
  "otherMails": [
    "String"
  ],
  "passwordPolicies": "String",
  "passwordProfile": {
    "@odata.type": "microsoft.graph.passwordProfile"
  },
  "pastProjects": [
    "String"
  ],
  "postalCode": "String",
  "preferredDataLocation": "String",
  "preferredLanguage": "String",
  "preferredName": "String",
  "provisionedPlans": [
    {
      "@odata.type": "microsoft.graph.provisionedPlan"
    }
  ],
  "proxyAddresses": [
    "String"
  ],
  "responsibilities": [
    "String"
  ],
  "schools": [
    "String"
  ],
  "securityIdentifier": "String",
  "serviceProvisioningErrors": [
    {
      "@odata.type": "microsoft.graph.serviceProvisioningXmlError"
    }
  ],
  "showInAddressList": true,
  "signInActivity": {
    "@odata.type": "microsoft.graph.signInActivity"
  },
  "signInSessionsValidFromDateTime": "String (timestamp)",
  "skills": [
    "String"
  ],
  "state": "String",
  "streetAddress": "String",
  "surname": "String",
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String",
  "calendar": {
    "@odata.type": "microsoft.graph.calendar"
  },
  "calendarGroups": [
    {
      "@odata.type": "microsoft.graph.calendarGroup"
    }
  ],
  "calendarView": [
    {
      "@odata.type": "microsoft.graph.event"
    }
  ],
  "calendars": [
    {
      "@odata.type": "microsoft.graph.calendar"
    }
  ],
  "contacts": [
    {
      "@odata.type": "microsoft.graph.contact"
    }
  ],
  "contactFolders": [
    {
      "@odata.type": "microsoft.graph.contactFolder"
    }
  ],
  "createdObjects": [
    {
      "@odata.type": "microsoft.graph.directoryObject"
    }
  ],
  "directReports": [
    {
      "@odata.type": "microsoft.graph.directoryObject"
    }
  ],
  "drive": {
    "@odata.type": "microsoft.graph.drive"
  },
  "drives": [
    {
      "@odata.type": "microsoft.graph.drive"
    }
  ],
  "events": [
    {
      "@odata.type": "microsoft.graph.event"
    }
  ],
  "inferenceClassification": {
    "@odata.type": "microsoft.graph.inferenceClassification"
  },
  "mailFolders": [
    {
      "@odata.type": "microsoft.graph.mailFolder"
    }
  ],
  "manager": {
    "@odata.type": "microsoft.graph.directoryObject"
  },
  "memberOf": [
    {
      "@odata.type": "microsoft.graph.directoryObject"
    }
  ],
  "messages": [
    {
      "@odata.type": "microsoft.graph.message"
    }
  ],
  "outlook": {
    "@odata.type": "microsoft.graph.outlookUser"
  },
  "ownedDevices": [
    {
      "@odata.type": "microsoft.graph.directoryObject"
    }
  ],
  "ownedObjects": [
    {
      "@odata.type": "microsoft.graph.directoryObject"
    }
  ],
  "photo": {
    "@odata.type": "microsoft.graph.profilePhoto"
  },
  "photos": [
    {
      "@odata.type": "microsoft.graph.profilePhoto"
    }
  ],
  "registeredDevices": [
    {
      "@odata.type": "microsoft.graph.directoryObject"
    }
  ]
}

Relationships

Microsoft Graph v1.0 exact-category-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship Type Description
activities userActivity collection The user's activities across devices. Read-only. Nullable.
adhocCalls adhocCall collection Ad hoc calls associated with the user. Read-only. Nullable.
agreementAcceptances agreementAcceptance collection The user's terms of use acceptance statuses. Read-only. Nullable.
appRoleAssignments appRoleAssignment collection Represents the app roles a user is granted for an application. Supports $expand.
authentication authentication The authentication methods that are supported for the user.
calendar calendar The user's primary calendar. Read-only.
calendarGroups calendarGroup collection The user's calendar groups. Read-only. Nullable.
calendars calendar collection The user's calendars. Read-only. Nullable.
calendarView event collection The calendar view for the calendar. Read-only. Nullable.
cloudPCs cloudPC collection The user's Cloud PCs. Read-only. Nullable.
contactFolders contactFolder collection The user's contacts folders. Read-only. Nullable.
contacts contact collection The user's contacts. Read-only. Nullable.
createdObjects directoryObject collection Directory objects that the user created. Read-only. Nullable.
dataSecurityAndGovernance userDataSecurityAndGovernance The data security and governance settings for the user. Read-only. Nullable.
directReports directoryObject collection The users and contacts that report to the user. (The users and contacts that have their manager property set to this user.) Read-only. Nullable. Supports $expand.
drive drive The user's OneDrive. Read-only.
drives drive collection A collection of drives available for this user. Read-only.
events event collection The user's events. Default is to show Events under the Default Calendar. Read-only. Nullable.
extensions extension collection The collection of open extensions defined for the user. Read-only. Supports $expand. Nullable.
inferenceClassification inferenceClassification Relevance classification of the user's messages based on explicit designations that override inferred relevance or importance.
insights itemInsights Represents relationships between a user and items such as OneDrive for work or school documents, calculated using advanced analytics and machine learning techniques. Read-only. Nullable.
licenseDetails licenseDetails collection A collection of this user's license details. Read-only.
mailFolders mailFolder collection The user's mail folders. Read-only. Nullable.
manager directoryObject The user or contact that is this user's manager. Read-only. Supports $expand.
memberOf directoryObject collection The groups and directory roles that the user is a member of. Read-only. Nullable. Supports $expand.
messages message collection The messages in a mailbox or folder. Read-only. Nullable.
onenote onenote Read-only.
onlineMeetings onlineMeeting collection Information about a meeting, including the URL used to join a meeting, the attendees list, and the description.
outlook outlookUser Read-only.
ownedDevices directoryObject collection Devices the user owns. Read-only. Nullable. Supports $expand and $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).
ownedObjects directoryObject collection Directory objects the user owns. Read-only. Nullable. Supports $expand, $select nested in $expand, and $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).
people person collection People that are relevant to the user. Read-only. Nullable.
permissionGrants resourceSpecificPermissionGrant collection List all resource-specific permission grants of a user.
photo profilePhoto The user's profile photo. Read-only.
photos profilePhoto collection The collection of the user's profile photos in different sizes. Read-only.
planner plannerUser Entry-point to the Planner resource that might exist for a user. Read-only.
registeredDevices directoryObject collection Devices that are registered for the user. Read-only. Nullable. Supports $expand and returns up to 100 objects.
solutions userSolutionRoot The identifier that relates the user to the working time schedule triggers. Read-Only. Nullable
sponsors directoryObject collection The users and groups responsible for this guest's privileges in the tenant and keeping the guest's information and access updated. (HTTP Methods: GET, POST, DELETE.). Supports $expand.
teamwork userTeamwork A container for Microsoft Teams features available for the user. Read-only. Nullable.
todo todo Represents the To Do services available to a user.
transitiveMemberOf directoryObject collection The groups, including nested groups, and directory roles that a user is a member of. Nullable.
assignedLicenses assignedLicense collection The licenses that are assigned to the user, including inherited (group-based) licenses. This property doesn't differentiate between directly assigned and inherited licenses. Use the licenseAssignmentStates property to identify the directly assigned and inherited licenses. Not nullable. Returned only on $select. Supports $filter (eq, not, /$count eq 0, /$count ne 0).
assignedPlans assignedPlan collection The plans that are assigned to the user. Read-only. Not nullable. Returned only on $select. Supports $filter (eq and not).
businessPhones string collection The telephone numbers for the user. NOTE: Although it's a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).
chats chat collection Related chats data exposed by this resource.
deviceManagementTroubleshootingEvents deviceManagementTroubleshootingEvent collection The list of troubleshooting events for this user.

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.

Methods
GET /admin/people/itemInsights
GET /groups/{id}/photo
GET /groups/{id}/photo/$value
GET /groups/{id}/photos/{size}
GET /me
GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo
GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
GET /me/contacts/{id}/photo
GET /me/contacts/{id}/photo/$value
GET /me/createdObjects
GET /me/photo
GET /me/photo/$value
GET /me/photos
GET /me/photos/{size}
GET /me/settings/itemInsights
GET /teams/{id}/photo
GET /teams/{id}/photo/$value
GET /users/{id | userPrincipalName}
GET /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo
GET /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
GET /users/{id | userPrincipalName}/contacts/{id}/photo
GET /users/{id | userPrincipalName}/contacts/{id}/photo/$value
GET /users/{id | userPrincipalName}/createdObjects
GET /users/{id | userPrincipalName}/photo
GET /users/{id | userPrincipalName}/photo/$value
GET /users/{id | userPrincipalName}/photos/{size}
GET /users/{userId}/settings/itemInsights
POST /me/translateExchangeIds
POST /users/{id}/retryServiceProvisioning
POST /users/{id|userPrincipalName}/translateExchangeIds
PATCH /groups/{id}/photo/$value
PATCH /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PATCH /me/contacts/{id}/photo/$value
PATCH /me/photo/$value
PATCH /me/settings
PATCH /me/settings/itemInsights
PATCH /users/{id | userPrincipalName}
PATCH /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/photo/$value
PATCH /users/{id | userPrincipalName}/settings/
PATCH /users/{userId}/settings/itemInsights
PUT /groups/{id}/photo/$value
PUT /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PUT /me/contacts/{id}/photo/$value
PUT /me/photo/$value
PUT /teams/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value
DELETE /groups/{id}/photo/$value
DELETE /me/photo/$value
DELETE /users/{id | userPrincipalName}/photo/$value
Exact Microsoft Learn match

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

Methods
GET /admin/people/itemInsights
GET /groups/{groupId}/cloudLicensing/usageRights/{usageRightId}
GET /groups/{id}/photo
GET /groups/{id}/photo/$value
GET /groups/{id}/photos/{size}
GET /me
GET /me/cloudLicensing/usageRights
GET /me/cloudLicensing/usageRights/{usageRightId}
GET /me/cloudLicensing/waitingMembers
GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo
GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
GET /me/contacts/{id}/photo
GET /me/contacts/{id}/photo/$value
GET /me/createdObjects
GET /me/photo
GET /me/photo/$value
GET /me/photos
GET /me/photos/{size}
GET /me/profile
GET /me/profile/account
GET /me/profile/account/{id}
GET /me/profile/addresses
GET /me/profile/addresses/{id}
GET /me/profile/anniversaries
GET /me/profile/anniversaries/{id}
GET /me/profile/awards
GET /me/profile/awards/{id}
GET /me/profile/certifications
GET /me/profile/certifications/{id}
GET /me/profile/educationalActivities
GET /me/profile/educationalActivities/{id}
GET /me/profile/emails
GET /me/profile/emails/{id}
GET /me/profile/interests
GET /me/profile/interests/{id}
GET /me/profile/languages
GET /me/profile/languages/{id}
GET /me/profile/names
GET /me/profile/names/{id}
GET /me/profile/notes
GET /me/profile/notes/{id}
GET /me/profile/patents
GET /me/profile/patents/{id}
GET /me/profile/phones
GET /me/profile/phones/{id}
GET /me/profile/positions
GET /me/profile/positions/{id}
GET /me/profile/projects
GET /me/profile/projects/{id}
GET /me/profile/publications
GET /me/profile/publications/{id}
GET /me/profile/skills
GET /me/profile/skills/{id}
GET /me/profile/webAccounts
GET /me/profile/webAccounts/{id}
GET /me/profile/websites
GET /me/profile/websites/{id}
GET /me/responsibilities
GET /me/responsibilities/{id}
GET /me/settings/contactMergeSuggestions
GET /me/settings/itemInsights
GET /teams/{id}/photo
GET /teams/{id}/photo/$value
GET /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo
GET /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
GET /users/{id | userPrincipalName}/contacts/{id}/photo
GET /users/{id | userPrincipalName}/contacts/{id}/photo/$value
GET /users/{id | userPrincipalName}/createdObjects
GET /users/{id | userPrincipalName}/photo
GET /users/{id | userPrincipalName}/photo/$value
GET /users/{id | userPrincipalName}/photos/{size}
GET /users/{id | userPrincipalName}/profile
GET /users/{id | userPrincipalName}/profile/account
GET /users/{id | userPrincipalName}/profile/account/{id}
GET /users/{id | userPrincipalName}/profile/addresses
GET /users/{id | userPrincipalName}/profile/addresses/{id}
GET /users/{id | userPrincipalName}/profile/anniversaries
GET /users/{id | userPrincipalName}/profile/anniversaries/{id}
GET /users/{id | userPrincipalName}/profile/awards
GET /users/{id | userPrincipalName}/profile/awards/{id}
GET /users/{id | userPrincipalName}/profile/certifications
GET /users/{id | userPrincipalName}/profile/certifications/{id}
GET /users/{id | userPrincipalName}/profile/educationalActivities
GET /users/{id | userPrincipalName}/profile/educationalActivities/{id}
GET /users/{id | userPrincipalName}/profile/emails
GET /users/{id | userPrincipalName}/profile/emails/{id}
GET /users/{id | userPrincipalName}/profile/interests
GET /users/{id | userPrincipalName}/profile/interests/{id}
GET /users/{id | userPrincipalName}/profile/languages
GET /users/{id | userPrincipalName}/profile/languages/{id}
GET /users/{id | userPrincipalName}/profile/names
GET /users/{id | userPrincipalName}/profile/names/{id}
GET /users/{id | userPrincipalName}/profile/notes
GET /users/{id | userPrincipalName}/profile/notes/{id}
GET /users/{id | userPrincipalName}/profile/patents
GET /users/{id | userPrincipalName}/profile/patents/{id}
GET /users/{id | userPrincipalName}/profile/phones
GET /users/{id | userPrincipalName}/profile/positions
GET /users/{id | userPrincipalName}/profile/positions/{id}
GET /users/{id | userPrincipalName}/profile/projects
GET /users/{id | userPrincipalName}/profile/projects/{id}
GET /users/{id | userPrincipalName}/profile/publications
GET /users/{id | userPrincipalName}/profile/publications/{id}
GET /users/{id | userPrincipalName}/profile/skills
GET /users/{id | userPrincipalName}/profile/skills/{id}
GET /users/{id | userPrincipalName}/profile/webAccounts
GET /users/{id | userPrincipalName}/profile/webAccounts/{id}
GET /users/{id | userPrincipalName}/profile/websites
GET /users/{id | userPrincipalName}/profile/websites/{id}
GET /users/{id | userPrincipalName}/responsibilities
GET /users/{id | userPrincipalName}/responsibilities/{id}
GET /users/{userId}/cloudLicensing/usageRights
GET /users/{userId}/cloudLicensing/usageRights/{usageRightId}
GET /users/{userId}/cloudLicensing/waitingMembers
GET /users/{userId}/profile/phones/{id}
GET /users/{userId}/settings/itemInsights
GET /users/{userId}/usageRights
POST /me/invalidateAllRefreshTokens
POST /me/profile/account
POST /me/profile/addresses
POST /me/profile/anniversaries
POST /me/profile/awards
POST /me/profile/certifications
POST /me/profile/educationalActivities
POST /me/profile/emails
POST /me/profile/interests
POST /me/profile/languages
POST /me/profile/names
POST /me/profile/notes
POST /me/profile/patents
POST /me/profile/phones
POST /me/profile/positions
POST /me/profile/projects
POST /me/profile/publications
POST /me/profile/skills
POST /me/profile/webAccounts
POST /me/profile/websites
POST /me/responsibilities
POST /me/translateExchangeIds
POST /users/{id | userPrincipalName}/invalidateAllRefreshTokens
POST /users/{id | userPrincipalName}/profile/account
POST /users/{id | userPrincipalName}/profile/addresses
POST /users/{id | userPrincipalName}/profile/anniversaries
POST /users/{id | userPrincipalName}/profile/awards
POST /users/{id | userPrincipalName}/profile/certifications
POST /users/{id | userPrincipalName}/profile/educationalActivities
POST /users/{id | userPrincipalName}/profile/emails
POST /users/{id | userPrincipalName}/profile/interests
POST /users/{id | userPrincipalName}/profile/languages
POST /users/{id | userPrincipalName}/profile/names
POST /users/{id | userPrincipalName}/profile/notes
POST /users/{id | userPrincipalName}/profile/patents
POST /users/{id | userPrincipalName}/profile/positions
POST /users/{id | userPrincipalName}/profile/projects
POST /users/{id | userPrincipalName}/profile/publications
POST /users/{id | userPrincipalName}/profile/skills
POST /users/{id | userPrincipalName}/profile/webAccounts
POST /users/{id | userPrincipalName}/profile/websites
POST /users/{id | userPrincipalName}/responsibilities
POST /users/{id}/retryServiceProvisioning
POST /users/{id|userPrincipalName}/translateExchangeIds
POST /users/{userId}/profile/phones
POST /users/validatePassword
PATCH /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PATCH /me/contacts/{id}/photo/$value
PATCH /me/profile/account/{id}
PATCH /me/profile/addresses/{id}
PATCH /me/profile/anniversaries/{id}
PATCH /me/profile/awards/{id}
PATCH /me/profile/certifications/{id}
PATCH /me/profile/educationalActivities/{id}
PATCH /me/profile/emails/{id}
PATCH /me/profile/interests/{id}
PATCH /me/profile/languages/{id}
PATCH /me/profile/names/{id}
PATCH /me/profile/notes/{id}
PATCH /me/profile/patents/{id}
PATCH /me/profile/phones/{id}
PATCH /me/profile/positions/{id}
PATCH /me/profile/projects/{id}
PATCH /me/profile/publications/{id}
PATCH /me/profile/skills/{id}
PATCH /me/profile/webAccounts/{id}
PATCH /me/profile/websites/{id}
PATCH /me/responsibilities/{id}
PATCH /me/settings
PATCH /me/settings/contactMergeSuggestions
PATCH /me/settings/itemInsights
PATCH /me/settings/regionalAndLanguageSettings
PATCH /users/{id | userPrincipalName}
PATCH /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/profile/account/{id}
PATCH /users/{id | userPrincipalName}/profile/addresses/{id}
PATCH /users/{id | userPrincipalName}/profile/anniversaries/{id}
PATCH /users/{id | userPrincipalName}/profile/awards/{id}
PATCH /users/{id | userPrincipalName}/profile/certifications/{id}
PATCH /users/{id | userPrincipalName}/profile/educationalActivities/{id}
PATCH /users/{id | userPrincipalName}/profile/emails/{id}
PATCH /users/{id | userPrincipalName}/profile/interests/{id}
PATCH /users/{id | userPrincipalName}/profile/languages/{id}
PATCH /users/{id | userPrincipalName}/profile/names/{id}
PATCH /users/{id | userPrincipalName}/profile/notes/{id}
PATCH /users/{id | userPrincipalName}/profile/patents/{id}
PATCH /users/{id | userPrincipalName}/profile/positions/{id}
PATCH /users/{id | userPrincipalName}/profile/projects/{id}
PATCH /users/{id | userPrincipalName}/profile/publications/{id}
PATCH /users/{id | userPrincipalName}/profile/skills/{id}
PATCH /users/{id | userPrincipalName}/profile/webAccounts/{id}
PATCH /users/{id | userPrincipalName}/profile/websites/{id}
PATCH /users/{id | userPrincipalName}/responsibilities/{id}
PATCH /users/{id | userPrincipalName}/settings/
PATCH /users/{user-id | userPrincipalName}/settings/regionalAndLanguageSettings
PATCH /users/{userId}/profile/phones/{id}
PATCH /users/{userId}/settings/itemInsights
PUT /groups/{id}/photo/$value
PUT /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PUT /me/contacts/{id}/photo/$value
PUT /me/photo/$value
PUT /me/settings/regionalAndLanguageSettings
PUT /teams/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value
PUT /users/{user-id | userPrincipalName}/settings/regionalAndLanguageSettings
DELETE /groups/{id}/photo/$value
DELETE /me/photo/$value
DELETE /me/profile
DELETE /me/profile/account/{id}
DELETE /me/profile/addresses/{id}
DELETE /me/profile/anniversaries/{id}
DELETE /me/profile/awards/{id}
DELETE /me/profile/certifications/{id}
DELETE /me/profile/educationalActivities/{id}
DELETE /me/profile/emails/{id}
DELETE /me/profile/interests/{id}
DELETE /me/profile/languages/{id}
DELETE /me/profile/names/{id}
DELETE /me/profile/notes/{id}
DELETE /me/profile/patents/{id}
DELETE /me/profile/phones/{itemPhoneId}
DELETE /me/profile/positions/{id}
DELETE /me/profile/projects/{id}
DELETE /me/profile/publications/{id}
DELETE /me/profile/skills/{id}
DELETE /me/profile/webAccounts/{id}
DELETE /me/profile/websites/{id}
DELETE /me/responsibilities/{id}
DELETE /users/{id | userPrincipalName}/photo/$value
DELETE /users/{id | userPrincipalName}/profile
DELETE /users/{id | userPrincipalName}/profile/account/{id}
DELETE /users/{id | userPrincipalName}/profile/addresses/{id}
DELETE /users/{id | userPrincipalName}/profile/anniversaries/{id}
DELETE /users/{id | userPrincipalName}/profile/awards/{id}
DELETE /users/{id | userPrincipalName}/profile/certifications/{id}
DELETE /users/{id | userPrincipalName}/profile/educationalActivities/{id}
DELETE /users/{id | userPrincipalName}/profile/emails/{id}
DELETE /users/{id | userPrincipalName}/profile/interests/{id}
DELETE /users/{id | userPrincipalName}/profile/languages/{id}
DELETE /users/{id | userPrincipalName}/profile/names/{id}
DELETE /users/{id | userPrincipalName}/profile/notes/{id}
DELETE /users/{id | userPrincipalName}/profile/patents/{id}
DELETE /users/{id | userPrincipalName}/profile/positions/{id}
DELETE /users/{id | userPrincipalName}/profile/projects/{id}
DELETE /users/{id | userPrincipalName}/profile/publications/{id}
DELETE /users/{id | userPrincipalName}/profile/skills/{id}
DELETE /users/{id | userPrincipalName}/profile/webAccounts/{id}
DELETE /users/{id | userPrincipalName}/profile/websites/{id}
DELETE /users/{id | userPrincipalName}/responsibilities/{id}
DELETE /users/{userId}/profile/phones/{itemPhoneId}
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgAdminPeopleItemInsight /admin/people/itemInsights
List itemInsights
Get-MgTeamPhoto /me/photo/$value
Get profilePhoto
Get-MgTeamPhotoContent /me/photo/$value
Get profilePhoto
Get-MgUser /me
Get user
Get-MgUserCreatedObject /users/{id | userPrincipalName}/createdObjects
List createdObjects
Get-MgUserPhoto /me/photo/$value
Get profilePhoto
Get-MgUserPhotoContent /me/photo/$value
Get profilePhoto
Get-MgUserSettingItemInsight /me/settings/itemInsights
Get userInsightsSettings
Invoke-MgRetryUserServiceProvisioning /users/{id}/retryServiceProvisioning
user: retryServiceProvisioning
Invoke-MgTranslateUserExchangeId /me/translateExchangeIds
user: translateExchangeIds
Remove-MgUserPhotoContent /me/photo/$value
Delete profilePhoto
Set-MgTeamPhotoContent /me/contacts/{id}/photo/$value
Update profilePhoto
Set-MgUserPhotoContent /me/contacts/{id}/photo/$value
Update profilePhoto
Update-MgUser /users/{id | userPrincipalName}
Update user
Update-MgUserSetting /me/settings
Update userSettings
Update-MgUserSettingItemInsight /me/settings/itemInsights
Update userInsightsSettings
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgBetaAdminPeopleItemInsight /admin/people/itemInsights
List itemInsights
Get-MgBetaUser /me
Get user
Get-MgBetaUserCreatedObject /users/{id | userPrincipalName}/createdObjects
List createdObjects
Get-MgBetaUserProfile /me/profile
Get profile
Get-MgBetaUserProfileAccount /me/profile/account
List accounts
Get-MgBetaUserProfileAccount /me/profile/account/{id}
Get userAccountInformation
Get-MgBetaUserProfileAddress /me/profile/addresses
List addresses
Get-MgBetaUserProfileAddress /me/profile/addresses/{id}
Get itemAddress
Get-MgBetaUserProfileAnniversary /me/profile/anniversaries
List anniversaries
Get-MgBetaUserProfileAnniversary /me/profile/anniversaries/{id}
Get personAnniversary
Get-MgBetaUserProfileAward /me/profile/awards
List awards
Get-MgBetaUserProfileAward /me/profile/awards/{id}
Get personAward
Get-MgBetaUserProfileCertification /me/profile/certifications
List certifications
Get-MgBetaUserProfileCertification /me/profile/certifications/{id}
Get personCertification
Get-MgBetaUserProfileEducationalActivity /me/profile/educationalActivities
List educationalActivities
Get-MgBetaUserProfileEducationalActivity /me/profile/educationalActivities/{id}
Get educationalActivity
Get-MgBetaUserProfileEmail /me/profile/emails
List emails
Get-MgBetaUserProfileEmail /me/profile/emails/{id}
Get itemEmail
Get-MgBetaUserProfileInterest /me/profile/interests
List interests
Get-MgBetaUserProfileInterest /me/profile/interests/{id}
Get personInterest
Get-MgBetaUserProfileLanguage /me/profile/languages
List languages
Get-MgBetaUserProfileLanguage /me/profile/languages/{id}
Get languageProficiency
Get-MgBetaUserProfileName /me/profile/names
List names
Get-MgBetaUserProfileName /me/profile/names/{id}
Get personName
Get-MgBetaUserProfileNote /me/profile/notes
List notes
Get-MgBetaUserProfileNote /me/profile/notes/{id}
Get personAnnotation
Get-MgBetaUserProfilePatent /me/profile/patents
List patents
Get-MgBetaUserProfilePatent /me/profile/patents/{id}
Get itemPatent
Get-MgBetaUserProfilePhone /me/profile/phones
List phones
Get-MgBetaUserProfilePhone /me/profile/phones/{id}
Get itemPhone
Get-MgBetaUserProfilePosition /me/profile/positions
List positions
Get-MgBetaUserProfilePosition /me/profile/positions/{id}
Get workPosition
Get-MgBetaUserProfileProject /me/profile/projects
List projects
Get-MgBetaUserProfileProject /me/profile/projects/{id}
Get projectParticipation
Get-MgBetaUserProfilePublication /me/profile/publications
List publications
Get-MgBetaUserProfilePublication /me/profile/publications/{id}
Get itemPublication
Get-MgBetaUserProfileSkill /me/profile/skills
List skills
Get-MgBetaUserProfileSkill /me/profile/skills/{id}
Get skillProficiency
Get-MgBetaUserProfileWebAccount /me/profile/webAccounts
List webAccounts
Get-MgBetaUserProfileWebAccount /me/profile/webAccounts/{id}
Get webAccount
Get-MgBetaUserProfileWebsite /me/profile/websites
List websites
Get-MgBetaUserProfileWebsite /me/profile/websites/{id}
Get personWebsite
Get-MgBetaUserSettingContactMergeSuggestion /me/settings/contactMergeSuggestions
Get contactMergeSuggestions
Get-MgBetaUserSettingItemInsight /me/settings/itemInsights
Get userInsightsSettings
Get-MgUser /me
Get user
Invoke-MgBetaInvalidateAllUserRefreshToken /me/invalidateAllRefreshTokens
user: invalidateAllRefreshTokens
Invoke-MgBetaRetryUserServiceProvisioning /users/{id}/retryServiceProvisioning
user: retryServiceProvisioning
Invoke-MgBetaTranslateUserExchangeId /me/translateExchangeIds
user: translateExchangeIds
New-MgBetaUserProfileAccount /me/profile/account
Create account
New-MgBetaUserProfileAddress /me/profile/addresses
Create addresses
New-MgBetaUserProfileAnniversary /me/profile/anniversaries
Create personAnniversary
New-MgBetaUserProfileAward /me/profile/awards
Create awards
New-MgBetaUserProfileCertification /me/profile/certifications
Create certifications
New-MgBetaUserProfileEducationalActivity /me/profile/educationalActivities
Create educationalActivity
New-MgBetaUserProfileEmail /me/profile/emails
Create itemEmail
New-MgBetaUserProfileInterest /me/profile/interests
Create personInterest
New-MgBetaUserProfileLanguage /me/profile/languages
Create languageProficiency
New-MgBetaUserProfileName /me/profile/names
Create personName
New-MgBetaUserProfileNote /me/profile/notes
Create notes
New-MgBetaUserProfilePatent /me/profile/patents
Create patents
New-MgBetaUserProfilePhone /me/profile/phones
Create itemPhone
New-MgBetaUserProfilePosition /me/profile/positions
Create workPosition
New-MgBetaUserProfileProject /me/profile/projects
Create projectParticipation
New-MgBetaUserProfilePublication /me/profile/publications
Create publications
New-MgBetaUserProfileSkill /me/profile/skills
Create skillProficiency
New-MgBetaUserProfileWebAccount /me/profile/webAccounts
Create webAccount
New-MgBetaUserProfileWebsite /me/profile/websites
Create personWebsite
Remove-MgBetaUserPhotoContent /me/photo/$value
Delete profilePhoto
Remove-MgBetaUserProfile /me/profile
Delete profile
Remove-MgBetaUserProfileAccount /me/profile/account/{id}
Delete userAccountInformation
Remove-MgBetaUserProfileAddress /me/profile/addresses/{id}
Delete itemAddress
Remove-MgBetaUserProfileAnniversary /me/profile/anniversaries/{id}
Delete personAnniversary
Remove-MgBetaUserProfileAward /me/profile/awards/{id}
Delete personAward
Remove-MgBetaUserProfileCertification /me/profile/certifications/{id}
Delete personCertification
Remove-MgBetaUserProfileEducationalActivity /me/profile/educationalActivities/{id}
Delete educationalActivity
Remove-MgBetaUserProfileEmail /me/profile/emails/{id}
Delete itemEmail
Remove-MgBetaUserProfileInterest /me/profile/interests/{id}
Delete personInterest
Remove-MgBetaUserProfileLanguage /me/profile/languages/{id}
Delete languageProficiency
Remove-MgBetaUserProfileName /me/profile/names/{id}
Delete personName
Remove-MgBetaUserProfileNote /me/profile/notes/{id}
Delete personAnnotation
Remove-MgBetaUserProfilePatent /me/profile/patents/{id}
Delete itemPatent
Remove-MgBetaUserProfilePhone /me/profile/phones/{itemPhoneId}
Delete itemPhone
Remove-MgBetaUserProfilePosition /me/profile/positions/{id}
Delete workPosition
Remove-MgBetaUserProfileProject /me/profile/projects/{id}
Delete projectParticipation
Remove-MgBetaUserProfilePublication /me/profile/publications/{id}
Delete itemPublication
Remove-MgBetaUserProfileSkill /me/profile/skills/{id}
Delete skillProficiency
Remove-MgBetaUserProfileWebAccount /me/profile/webAccounts/{id}
Delete webAccount
Remove-MgBetaUserProfileWebsite /me/profile/websites/{id}
Delete personWebsite
Set-MgBetaTeamPhotoContent /me/contacts/{id}/photo/$value
Update profilePhoto
Set-MgBetaUserPhotoContent /me/contacts/{id}/photo/$value
Update profilePhoto
Test-MgBetaUserPassword /users/validatePassword
user: validatePassword
Update-MgBetaUser /users/{id | userPrincipalName}
Update user or agentUser
Update-MgBetaUserProfileAccount /me/profile/account/{id}
Update userAccountInformation
Update-MgBetaUserProfileAddress /me/profile/addresses/{id}
Update itemAddress
Update-MgBetaUserProfileAnniversary /me/profile/anniversaries/{id}
Update personAnniversary
Update-MgBetaUserProfileAward /me/profile/awards/{id}
Update personAward
Update-MgBetaUserProfileCertification /me/profile/certifications/{id}
Update personCertification
Update-MgBetaUserProfileEducationalActivity /me/profile/educationalActivities/{id}
Update educationalactivity
Update-MgBetaUserProfileEmail /me/profile/emails/{id}
Update itememail
Update-MgBetaUserProfileInterest /me/profile/interests/{id}
Update personInterest
Update-MgBetaUserProfileLanguage /me/profile/languages/{id}
Update languageProficiency
Update-MgBetaUserProfileName /me/profile/names/{id}
Update personName
Update-MgBetaUserProfileNote /me/profile/notes/{id}
Update personAnnotation
Update-MgBetaUserProfilePatent /me/profile/patents/{id}
Update itemPatent
Update-MgBetaUserProfilePhone /me/profile/phones/{id}
Update itemphone
Update-MgBetaUserProfilePosition /me/profile/positions/{id}
Update workPosition
Update-MgBetaUserProfileProject /me/profile/projects/{id}
Update projectParticipation resource type
Update-MgBetaUserProfilePublication /me/profile/publications/{id}
Update itemPublication
Update-MgBetaUserProfileSkill /me/profile/skills/{id}
Update skillProficiency
Update-MgBetaUserProfileWebAccount /me/profile/webAccounts/{id}
Update webAccount
Update-MgBetaUserProfileWebsite /me/profile/websites/{id}
Update personWebsite
Update-MgBetaUserSettingContactMergeSuggestion /me/settings/contactMergeSuggestions
Update contactMergeSuggestions
Update-MgBetaUserSettingItemInsight /me/settings/itemInsights
Update userInsightsSettings
Update-MgBetaUserSettingRegionalAndLanguageSetting /me/settings/regionalAndLanguageSettings
Update regionalAndLanguageSettings

Code Examples

C# / .NET SDK
Delete profilePhoto
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
await graphClient.Me.Photo.Content.DeleteAsync();
JavaScript
Delete profilePhoto
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/me/photo/$value')
	.delete();
PowerShell
Delete profilePhoto
View official example on Microsoft Learn
Import-Module Microsoft.Graph.Users
# A UPN can also be used as -UserId.
Remove-MgUserPhotoContent -UserId $userId
Python
Delete profilePhoto
View official example on Microsoft Learn
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.me.photo.content.delete()

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 Delegated permissions and search for User.ReadWrite

4

Grant Admin Consent

Users can consent to this permission during sign-in.