ESC
Type to search...

profile

Export JSON
Export CSV
Copy URL
Print
Delegated Read User Scope

Allows the app to see your users' basic profile (e.g., name, picture, user name, email address)

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

Permission Details

Delegated Permission User consent allowed

View users' basic profile

Allows the app to see your users' basic profile (e.g., name, picture, user name, email address)

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
id String Read-only.
account userAccountInformation collection
addresses itemAddress collection Represents details of addresses associated with the user.
anniversaries personAnnualEvent collection Represents the details of meaningful dates associated with a person.
awards personAward collection Represents the details of awards or honors associated with a person.
certifications personCertification collection Represents the details of certifications associated with a person.
educationalActivities educationalActivity collection Represents data that a user has supplied related to undergraduate, graduate, postgraduate or other educational activities.
emails itemEmail collection Represents detailed information about email addresses associated with the user.
interests personInterest collection Provides detailed information about interests the user has associated with themselves in various services.
languages languageProficiency collection Represents detailed information about languages that a user has added to their profile.
names personName collection Represents the names a user has added to their profile.
notes personAnnotation collection Represents notes that a user has added to their profile.
patents itemPatent collection Represents patents that a user has added to their profile.
phones itemPhone collection Represents detailed information about phone numbers associated with a user in various services.
positions workPosition collection Represents detailed information about work positions associated with a user's profile.

Showing 15 of 20 properties.

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
{
  "id": "String (identifier)"
}

Relationships

Microsoft Graph beta exact-category-docs

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

Relationship Type Description
accounts userAccountInformation collection Represents information specifically tied to a user's account.
addresses itemAddress collection Represents details of addresses associated with the user.
anniversaries personAnniversary collection Represents the details of meaningful dates associated with a person.
awards personAward collection Represents the details of awards or honors associated with a person.
certifications personCertification collection Represents the details of certifications associated with a person.
educationalActivities educationalActivity collection Represents data that a user has supplied related to undergraduate, graduate, postgraduate or other educational activities.
emails itemEmail collection Represents detailed information about email addresses associated with the user.
interests personInterest collection Provides detailed information about interests the user has associated with themselves in various services.
languages languageProficiency collection Represents detailed information about languages that a user has added to their profile.
names personName collection Represents the names a user has added to their profile.
notes personAnnotation collection Represents notes that a user has added to their profile.
patents itemPatent collection Represents patents that a user has added to their profile.
phones itemPhone collection Represents detailed information about phone numbers associated with a user in various services.
positions workPosition collection Represents detailed information about work positions associated with a user's profile.
projects projectParticipation collection Represents detailed information about projects associated with a user.
publications itemPublication collection Represents details of any publications a user has added to their profile.
responsibilities personResponsibility collection Represents details of responsibilities a user has added to their profile.
skills skillProficiency collection Represents detailed information about skills associated with a user in various services.
webAccounts webAccount collection Represents web accounts the user has indicated they use or has added to their user profile.
websites personWebsite collection Represents detailed information about websites associated with a user in various services.
account userAccountInformation collection Related account data exposed by this resource.

Graph Methods

Delegated access App-only access
No Learn or OpenAPI mapping available

Microsoft Graph v1.0 endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.

No API methods available for this version.

No Learn or OpenAPI mapping available

Microsoft Graph beta endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.

No API methods available for this version.

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs
No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

Code Examples

C# / .NET SDK
using Azure.Identity;
using Microsoft.Graph;

var scopes = new[] { "profile" };
var credential = new InteractiveBrowserCredential(
    new InteractiveBrowserCredentialOptions
    {
        ClientId = "YOUR_CLIENT_ID",
        TenantId = "YOUR_TENANT_ID",
        RedirectUri = new Uri("http://localhost")
    });

var graphClient = new GraphServiceClient(credential, scopes);
var response = await graphClient
    .WithUrl("https://graph.microsoft.com/v1.0/profile")
    .GetAsync();
JavaScript
import { Client } from "@microsoft/microsoft-graph-client";
import { InteractiveBrowserCredential } from "@azure/identity";

const credential = new InteractiveBrowserCredential({
  clientId: "YOUR_CLIENT_ID",
  tenantId: "YOUR_TENANT_ID",
  redirectUri: "http://localhost"
});

const token = await credential.getToken(["profile"]);
const client = Client.init({
  authProvider: (done) => done(null, token.token)
});

const response = await client.api("/profile").get();
PowerShell
Connect-MgGraph -Scopes "profile"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/profile"
Python
from azure.identity import InteractiveBrowserCredential
import requests

credential = InteractiveBrowserCredential(
    client_id="YOUR_CLIENT_ID",
    tenant_id="YOUR_TENANT_ID"
)

token = credential.get_token("profile")
response = requests.get(
    "https://graph.microsoft.com/v1.0/profile",
    headers={"Authorization": f"Bearer {token.token}"}
)

print(response.json())

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 profile

4

Grant Admin Consent

Users can consent to this permission during sign-in.