userAccountInformation 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 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.

Methods

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

Properties

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. 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.
preferredLanguageTag	localeInfo	Contains the language the user has associated as preferred for the account.
source	personDataSource	Where the values originated if synced from another service. Inherited from itemFacet.
userPrincipalName	String	The user principal name (UPN) of the user associated with the account.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.userAccountInformation",
  "id": "String (identifier)",
  "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"
  },
  "ageGroup": "String",
  "countryCode": "String",
  "preferredLanguageTag": {
    "@odata.type": "microsoft.graph.localeInfo"
  },
  "userPrincipalName": "String"
}