presence resource type

Namespace: microsoft.graph

Contains information about a user's presence, including their availability and user activity.

Note: This resource is currently only supported for Microsoft Teams users.

This resource supports subscribing to change notifications.


Method Return Type Description
Get presence presence Get a user's presence information.
Get presence of multiple users presence collection Get the presence information for multiple users.
Set presence Set an application's presence session for a user.
Clear presence Clear an application's presence session for a user.
Set user preferred presence Set the preferred availability and activity status for a user.
Clear user preferred presence Clear the preferred availability and activity status for a user.
Set user status message Set a presence status message for a user.


Property Type Description
activity String collection The supplemental information to a user's availability. Possible values are Available, Away, BeRightBack, Busy, DoNotDisturb, InACall, InAConferenceCall, Inactive, InAMeeting, Offline, OffWork, OutOfOffice, PresenceUnknown, Presenting, UrgentInterruptionsOnly.
availability String collection The base presence information for a user. Possible values are Available, AvailableIdle, Away, BeRightBack, Busy, BusyIdle, DoNotDisturb, Offline, PresenceUnknown
id String The unique identifier for the user.
statusMessage presenceStatusMessage The presence status message of a user.

Note: To learn more about the different presence states, see User presence in Teams.



JSON representation

The following is a JSON representation of the resource.

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