Presence.Read | Graph Permissions

Permission Details

Delegated Permission

Read user's presence information

Allows the app to read presence information on behalf of the signed-in user. Presence information includes activity, availability, status note, calendar out-of-office message, timezone and location.

Permission ID: 76bc735e-aecd-4a1d-8b4c-2b915deabb79

Properties

Microsoft Graph v1.0 exact-category-docs

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

Property	Type	Description
`activity`	`String`Nullable	The supplemental information to a user's availability. Possible values are available, away, beRightBack, busy, doNotDisturb, offline, outOfOffice, presenceUnknown.
`availability`	`String`Nullable	The base presence information for a user. Possible values are available, away, beRightBack, busy, doNotDisturb, focusing, inACall, inAMeeting, offline, presenting, presenceUnknown.
`id`	`String`	The unique identifier for the user.
`outOfOfficeSettings`	`outOfOfficeSettings`	The out of office settings for a user.
`sequenceNumber`	`String`Read-onlyNullable	The lexicographically sortable String stamp that represents the version of a presence object.
`statusMessage`	`presenceStatusMessage`	The presence status message of a user.
`workLocation`	`userWorkLocation`	Represents the user’s aggregated work location state.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

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

JSON representation

{
  "activity": "String",
  "availability": "String",
  "id": "String (identifier)",
  "outOfOfficeSettings": {
    "@odata.type": "#microsoft.graph.outOfOfficeSettings"
  },
  "sequenceNumber": "String",
  "statusMessage": {
    "@odata.type": "#microsoft.graph.presenceStatusMessage"
  },
  "workLocation": {
    "@odata.type": "microsoft.graph.userWorkLocation"
  }
}

Relationships

Microsoft Graph v1.0 exact-category

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

Relationship	Type	Description
`statusMessage`	`presenceStatusMessage`	Presence status message of a 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 `/communications/presences/{id}`
GET `/me/presence`
GET `/users/{id}/presence`

Exact Microsoft Learn match

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

Methods
GET `/communications/presences/{id}`
GET `/me/presence`
GET `/users/{id}/presence`

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgCommunicationPresence` /users/{id}/presence Get presence
`Get-MgUserPresence` /users/{id}/presence Get presence

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgBetaCommunicationPresence` /users/{id}/presence Get presence
`Get-MgBetaUserPresence` /users/{id}/presence Get presence

Code Examples

C# / .NET SDK

Get presence

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.Me.Presence.GetAsync();

JavaScript

Get presence

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

let presence = await client.api('/me/presence')
	.get();

PowerShell

Get presence

View official example on Microsoft Learn

Import-Module Microsoft.Graph.CloudCommunications
# A UPN can also be used as -UserId.
Get-MgUserPresence -UserId $userId

Python

Get presence

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

result = await graph_client.me.presence.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 Delegated permissions and search for Presence.Read

4

Grant Admin Consent

Users can consent to this permission during sign-in.