Presence.ReadWrite

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

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the Presence.ReadWrite permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	-	8d3c54a7-cf58-4773-bf81-c0cd6ad522bb
DisplayText	-	Read and write a user's presence information
Description	-	Allows the app to read the presence information and write activity and availability on behalf of the signed-in user. Presence information includes activity, availability, status note, calendar out-of-office message, timezone and location.
AdminConsentRequired	Yes	No

Graph Methods

• API [v1.0]
• API [beta]
• PowerShell [v1.0]
• PowerShell [beta]

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	POST /users/{userId}/presence/clearPresence
	POST /users/{userId}/presence/clearUserPreferredPresence
	POST /users/{userId}/presence/setPresence
	POST /users/{userId}/presence/setStatusMessage
	POST /users/{userId}/presence/setUserPreferredPresence

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

• presenceStatusMessage

Graph reference: presenceStatusMessage

Property	Type	Description
expiryDateTime	dateTimeTimeZone	Time in which the status message expires. If not provided, the status message doesn't expire. expiryDateTime.dateTime shouldn't include time zone. expiryDateTime isn't available when you request the presence of another user.
message	itemBody	Status message item. The only supported format currently is message.contentType = 'text'.
publishedDateTime	DateTimeOffset	Time in which the status message was published. Read-only. **p