Skip to content

usereventssummary.md

Latest commit

 

History

History
65 lines (54 loc) · 2.7 KB

usereventssummary.md

File metadata and controls

65 lines (54 loc) · 2.7 KB
title userEventsSummary resource type
description Represents a specific user MFA/SSPR registration or reset event, including whether the event was successful, which authentication method was targeted, and failure reason if any.
author egreenberg14
ms.localizationpriority medium
ms.subservice entra-monitoring-health
doc_type resourcePageType
ms.date 01/12/2026

userEventsSummary resource type

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Represents a specific user MFA/SSPR registration or reset event, including whether the event was successful, which authentication method was targeted, and failure reason if any.

Inherits from entity.

Methods

Method Return type Description
List userEventsSummary collection Get a list of the user registration and reset events as defined in the userEventsSummary object.

Properties

Property Type Description
authMethod usageAuthMethod The authentication method being targeted in the event.
eventDateTime DateTimeOffset The date and time (UTC) when the event occurred. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
failureReason String The specific reason why the event failed (if it was not successful.)
feature featureType The type of event that occurred. The possible values are: registration, reset, unknownFutureValue.
id String User object identifier in Microsoft Entra ID. Inherited from entity.
isSuccess Boolean Indicates whether the event was successful or not.
userDisplayName String The user display name, such as Adele Vance. Supports $filter (eq, startsWith) and $orderby.
userPrincipalName String The user principal name, such as AdeleV@contoso.com. Supports $filter (eq, startsWith) and $orderby.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.userEventsSummary",
  "id": "String (identifier)",
  "feature": "String",
  "userPrincipalName": "String",
  "userDisplayName": "String",
  "isSuccess": "Boolean",
  "authMethod": "String",
  "failureReason": "String",
  "eventDateTime": "String (timestamp)"
}