Skip to content

emailauthenticationmethod.md

Latest commit

 

History

History
63 lines (52 loc) · 3.25 KB

emailauthenticationmethod.md

File metadata and controls

63 lines (52 loc) · 3.25 KB
title emailAuthenticationMethod resource type
description A representation of an email address registered to a user. Email is an authentication method available only to self-service password reset (SSPR)
author tilarso
ms.reviewer intelligentaccesspm
ms.localizationpriority medium
ms.subservice entra-sign-in
doc_type resourcePageType
toc.title Email
ms.date 07/24/2025

emailAuthenticationMethod resource type

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

A representation of an email address registered to a user. Email is an authentication method available only to self-service password reset (SSPR). Users may only have one email authentication method.

This is a derived type that inherits from the authenticationMethod resource type.

Methods

Method Return type Description
List emailAuthenticationMethod collection Retrieve a list of a user's emailAuthenticationMethods. Users may only have one email authentication method.
Add emailAuthenticationMethod Create a user's emailMethod object.
Get emailAuthenticationMethod Retrieve the properties of the user's emailAuthenticationMethod object.
Update emailAuthenticationMethod Update the properties of a user's emailMethods object.
Delete None Delete a user's emailAuthenticationMethod object.

Properties

Property Type Description
id String The identifier of the email address registered to this user. The ID is always 3ddfcfc8-9383-446f-83cc-3ab9be4be18f.
createdDateTime DateTimeOffset The date and time the authentication method was registered to the user. Read-only. Optional. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
lastUsedDateTime DateTimeOffset The date and time the authentication method was last used by the user. Read-only. Optional. This optional value is null if the authentication method doesn't populate it. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from authenticationMethod.
emailAddress String The email address registered to this user.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.emailAuthenticationMethod",
  "createdDateTime": "String (timestamp)",
  "lastUsedDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "emailAddress": "String"
}