Microsoft Office 365 · Schema
Microsoft Office 365 User
Represents an Azure Active Directory (Entra ID) user account accessed through the Microsoft Graph API. A user resource contains profile information, organizational hierarchy, contact details, assigned licenses, and managed resources. This schema models the user resource as documented at https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0
CloudCollaborationEnterpriseMicrosoftProductivity
Properties
| Name | Type | Description |
|---|---|---|
| id | string | The unique identifier for the user. Inherited from directoryObject. A GUID value assigned by Azure AD and immutable once set. |
| displayName | stringnull | The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial, and last name. Maximum length is 256 characters. |
| givenName | stringnull | The given name (first name) of the user. Maximum length is 64 characters. |
| surname | stringnull | The user's surname (family name or last name). Maximum length is 64 characters. |
| stringnull | The SMTP address for the user, for example, [email protected]. Changes to this property also update the user's proxyAddresses collection to include the value as an SMTP address. This property cannot c | |
| userPrincipalName | string | The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The gen |
| mailNickname | stringnull | The mail alias for the user. This property must be specified when a user is created. Maximum length is 64 characters. |
| jobTitle | stringnull | The user's job title. Maximum length is 128 characters. |
| department | stringnull | The name of the department in which the user works. Maximum length is 64 characters. |
| officeLocation | stringnull | The office location in the user's place of business. Maximum length is 128 characters. |
| companyName | stringnull | The company name which the user is associated with. This property can be useful for describing the company that an external user comes from. Maximum length is 64 characters. |
| businessPhones | array | The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. |
| mobilePhone | stringnull | The primary cellular telephone number for the user. Read-only for users synced from on-premises directory. |
| faxNumber | stringnull | The fax number of the user. |
| streetAddress | stringnull | The street address of the user's place of business. Maximum length is 1024 characters. |
| city | stringnull | The city in which the user is located. Maximum length is 128 characters. |
| state | stringnull | The state or province in the user's address. Maximum length is 128 characters. |
| postalCode | stringnull | The postal code for the user's postal address. The postal code is specific to the user's country/region. Maximum length is 40 characters. |
| country | stringnull | The country or region in which the user is located; for example, US or UK. Maximum length is 128 characters. |
| usageLocation | stringnull | A two-letter country code (ISO standard 3166). Required for users that are assigned licenses due to legal requirements to check for availability of services in countries. Examples include: US, JP, and |
| preferredLanguage | stringnull | The preferred language for the user. Should follow ISO 639-1 Code; for example en-US. |
| preferredDataLocation | stringnull | The preferred data location for the user, used in multi-geo environments. |
| accountEnabled | booleannull | true if the account is enabled; otherwise, false. This property is required when a user is created. |
| ageGroup | stringnull | Sets the age group of the user. |
| consentProvidedForMinor | stringnull | Sets whether consent has been obtained for minors. |
| legalAgeGroupClassification | stringnull | Used by enterprise applications to determine the legal age group of the user. This property is read-only and calculated based on ageGroup and consentProvidedForMinor properties. |
| employeeId | stringnull | The employee identifier assigned to the user by the organization. Maximum length is 16 characters. |
| employeeType | stringnull | Captures enterprise worker type. For example, Employee, Contractor, Consultant, or Vendor. |
| employeeHireDate | stringnull | The date and time when the user was hired or will start work in a future hire. |
| employeeOrgData | objectnull | Represents organization data (e.g., division and costCenter) associated with a user. |
| userType | stringnull | A string value that can be used to classify user types in your directory, such as Member and Guest. |
| externalUserState | stringnull | For an external user invited to the tenant, this property represents the invited user's invitation status. |
| externalUserStateChangeDateTime | stringnull | Shows the timestamp for the latest change to the externalUserState property. |
| createdDateTime | stringnull | The date and time the user was created, in ISO 8601 format and UTC time. |
| lastSignInDateTime | stringnull | The date and time of the user's most recent interactive or non-interactive sign-in activity. Read-only and returned only on $select. |
| deletedDateTime | stringnull | The date and time the user was deleted. Returned only on $select. |
| onPremisesImmutableId | stringnull | This property is used to associate an on-premises Active Directory user account to their Azure AD user object. Must be specified when creating a new user account if using a federated domain for the us |
| onPremisesLastSyncDateTime | stringnull | Indicates the last time at which the object was synced with the on-premises directory. |
| onPremisesSyncEnabled | booleannull | true if this user object is currently being synced from an on-premises Active Directory; otherwise the user isn't being synced and can be managed in Azure Active Directory. |
| onPremisesSamAccountName | stringnull | Contains the on-premises samAccountName synchronized from the on-premises directory. |
| onPremisesDomainName | stringnull | Contains the on-premises domainFQDN (also called dnsDomainName) synchronized from the on-premises directory. |
| onPremisesDistinguishedName | stringnull | Contains the on-premises Active Directory distinguished name or DN. |
| onPremisesSecurityIdentifier | stringnull | Contains the on-premises security identifier (SID) for the user. |
| onPremisesUserPrincipalName | stringnull | Contains the on-premises userPrincipalName synchronized from the on-premises directory. |
| proxyAddresses | array | For example: ["SMTP: [email protected]", "smtp: [email protected]"]. Changes to the mail property also update this collection to include the value as an SMTP address. |
| otherMails | array | A list of additional email addresses for the user; for example: ["[email protected]", "[email protected]"]. |
| imAddresses | array | The instant message voice-over IP (VOIP) session initiation protocol (SIP) addresses for the user. |
| showInAddressList | booleannull | true if the Outlook global address list should contain this user; otherwise, false. |
| passwordProfile | objectnull | Specifies the password profile for the user. The profile contains the user's password. Required when creating a user. |
| passwordPolicies | stringnull | Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. Disab |
| identities | array | Represents the identities that can be used to sign in to this user account. An identity can be provided by Microsoft (also known as a local account), by organizations, or by social identity providers |
| assignedLicenses | array | The licenses that are assigned to the user, including inherited (group-based) licenses. |
| assignedPlans | array | The plans that are assigned to the user. |
| provisionedPlans | array | The plans that are provisioned for the user. |
| aboutMe | stringnull | A freeform text entry field for the user to describe themselves. Returned only on $select. |
| birthday | stringnull | The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. Returned only on $select. |
| hireDate | stringnull | The hire date of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Returned only on $select. |
| interests | array | A list for the user to describe their interests. Returned only on $select. |
| mySite | stringnull | The URL for the user's personal site. Returned only on $select. |
| pastProjects | array | A list for the user to enumerate their past projects. Returned only on $select. |
| responsibilities | array | A list for the user to enumerate their responsibilities. Returned only on $select. |
| schools | array | A list for the user to enumerate the schools they have attended. Returned only on $select. |
| skills | array | A list for the user to enumerate their skills. Returned only on $select. |
| signInActivity | objectnull | Get the last signed-in date and request ID of the sign-in for a given user. Read-only. Returned only on $select. |