itemEmail resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents detailed information about email addresses associated with the user.

Inherits from itemFacet.

Methods

Method	Return type	Description
List emails	itemEmail collection	Get the itemEmail resources from the emails navigation property.
Create itemEmail	itemEmail	Create a new itemEmail object.
Get itemEmail	itemEmail	Read the properties and relationships of an itemEmail object.
Update itemEmail	itemEmail	Update the properties of an itemEmail object.
Delete itemEmail	None	Deletes an itemEmail object.

Properties

Property	Type	Description
address	String	The email address itself.
allowedAudiences	String	The audiences that are able to see the values contained within the entity. Inherited from itemFacet. Possible values are: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.
createdBy	identitySet	Provides the identifier of the user and/or application that created the entity. Inherited from itemFacet.
createdDateTime	DateTimeOffset	Provides the dateTimeOffset for when the entity was created. Inherited from itemFacet.
displayName	String	The name or label a user has associated with a particular email address.
id	String	Identifier used for individually addressing the entity. Inherited from entity
inference	inferenceData	Contains inference detail if the entity is inferred by the creating or modifying application. Inherited from itemFacet.
lastModifiedBy	identitySet	Provides the identifier of the user and/or application that last modified the entity. Inherited from itemFacet.
lastModifiedDateTime	DateTimeOffset	Provides the dateTimeOffset for when the entity was created. Inherited from itemFacet.
source	personDataSource	Where the values originated if synced from another service. Inherited from itemFacet.
type	emailType	The type of email address. Possible values are: unknown, work, personal, main, other.

Relationships

None.

JSON representation

The following is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.itemEmail",
  "id": "0f30bf5d-bf5d-0f30-5dbf-300f5dbf300f",
  "allowedAudiences": "String",
  "inference": {
    "@odata.type": "microsoft.graph.inferenceData"
  },
  "createdDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "source": {
    "@odata.type": "microsoft.graph.personDataSource"
  },
  "address": "String",
  "displayName": "String",
  "type": "String"
}