| title | itemEmail resource type |
|---|---|
| description | itemEmail resource type |
| ms.localizationpriority | medium |
| author | kevinbellinger |
| ms.subservice | people |
| doc_type | resourcePageType |
| ms.date | 07/22/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Represents detailed information about email addresses associated with the user.
Inherits from itemFacet.
| Method | Return type | Description |
|---|---|---|
| List | itemEmail collection | Get the itemEmail resources from the emails navigation property. |
| Create | itemEmail | Create a new itemEmail object. |
| Get | itemEmail | Read the properties and relationships of an itemEmail object. |
| Update | itemEmail | Update the properties of an itemEmail object. |
| Delete | None | Deletes an itemEmail object. |
| 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. The 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. The possible values are: unknown, work, personal, main, other. |
None.
The following JSON representation shows the resource type.
{
"@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"
}