| title | userAccountInformation resource type |
|---|---|
| description | userAccountInformation resource type |
| ms.localizationpriority | medium |
| author | kevinbellinger |
| ms.subservice | people |
| doc_type | resourcePageType |
| ms.date | 06/10/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Represents information tied to a user's account, whether that is as a Microsoft Entra account or Microsoft account. The entity identifier is set to the corresponding Microsoft Entra guid or Microsoft Account CID respectively. These fields are read-only through Microsoft Graph and must be edited through a users' profile or by a Tenant Administrator on a corresponding experience.
Inherits from itemFacet.
| Method | Return type | Description |
|---|---|---|
| List | userAccountInformation collection | Get the userAccountInformation resources from the account navigation property. |
| Create | userAccountInformation | Create a new userAccountInformation object. |
| Get | userAccountInformation | Read the properties and relationships of a userAccountInformation object. |
| Update | userAccountInformation | Update the properties of a userAccountInformation object. |
| Delete | None | Delete a userAccountInformation object. |
| Property | Type | Description |
|---|---|---|
| ageGroup | String | Shows the age group of user. Allowed values null, minor, notAdult and adult are generated by the directory and can't be changed. |
| 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. |
| countryCode | String | Contains the two-character country code associated with the users' account. |
| 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. |
| 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. |
| originTenantInfo | originTenantInfo | Contains the identifiers of the user and the origin tenant that provisioned the user. This property is populated when the user is invited as a guest to the host tenant. |
| preferredLanguageTag | localeInfo | Contains the language that the user associated as preferred for their account. |
| source | personDataSource | Where the values originated if synced from another service. Inherited from itemFacet. |
| userPersona | userPersona | Represents the user's persona. The possible values are: unknown, externalMember, externalGuest, internalMember, internalGuest, unknownFutureValue. |
| userPrincipalName | String | The user principal name (UPN) of the user associated with the account. |
None.
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.userAccountInformation",
"ageGroup": "String",
"allowedAudiences": "String",
"countryCode": "String",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"id": "String (identifier)",
"inference": {"@odata.type": "microsoft.graph.inferenceData"},
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"originTenantInfo": {"@odata.type": "microsoft.graph.originTenantInfo"},
"preferredLanguageTag": {"@odata.type": "microsoft.graph.localeInfo"},
"source": {"@odata.type": "microsoft.graph.personDataSource"},
"userPersona": "String",
"userPrincipalName": "String"
}