Microsoft Azure Active Directory · Schema

User

Represents an Azure AD user account. Inherits from directoryObject. Contains identity, profile, organizational, and authentication properties.

AuthenticationAuthorizationIdentityMicrosoftMicrosoft EntraOAuthOpenID ConnectSAMLSCIMSingle Sign-OnZero Trust

Properties

Name	Type	Description
accountEnabled	boolean	True if the account is enabled; otherwise, false.
assignedLicenses	array	The licenses that are assigned to the user.
assignedPlans	array	The plans that are assigned to the user.
businessPhones	array	The telephone numbers for the user.
city	stringnull	The city where the user is located.
companyName	stringnull	The company name associated with the user.
country	stringnull	The country or region where the user is located.
createdDateTime	string	The date and time the user was created.
department	stringnull	The department in which the user works.
displayName	string	The name displayed in the address book for the user. Required on creation.
employeeId	stringnull	The employee identifier assigned to the user by the organization.
employeeType	stringnull	Captures the enterprise worker type. For example, Employee, Contractor, Consultant, or Vendor.
givenName	stringnull	The given name (first name) of the user.
jobTitle	stringnull	The user's job title.
mail	stringnull	The SMTP address for the user.
mailNickname	string	The mail alias for the user. Required on creation.
mobilePhone	stringnull	The primary cellular telephone number for the user.
officeLocation	stringnull	The office location in the user's place of business.
onPremisesDistinguishedName	stringnull	The on-premises Active Directory distinguished name.
onPremisesDomainName	stringnull	The on-premises domain name.
onPremisesImmutableId	stringnull	Used to associate an on-premises Active Directory user account to the Azure AD user object.
onPremisesLastSyncDateTime	stringnull	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.
otherMails	array	Additional email addresses for the user.
passwordPolicies	stringnull	Specifies password policies for the user. One of DisableStrongPassword and DisablePasswordExpiration, or both.
postalCode	stringnull	The postal code for the user's postal address.
preferredLanguage	stringnull	The preferred language for the user in ISO 639-1 code format. Example: en-US.
proxyAddresses	array	The proxy addresses for the user. Example: SMTP:[email protected], smtp:[email protected].
signInSessionsValidFromDateTime	string	Any refresh tokens or session tokens issued before this time are invalid.
state	stringnull	The state or province in the user's address.
streetAddress	stringnull	The street address of the user's place of business.
surname	stringnull	The user's surname (family name or last name).
usageLocation	stringnull	A two-letter country code (ISO 3166). Required for users who will be assigned licenses.
userPrincipalName	string	The user principal name (UPN) of the user. Required on creation. Format: alias@domain.
userType	stringnull	A string value that classifies the user. Typically Member or Guest.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/User",
  "title": "User",
  "type": "object",
  "description": "Represents an Azure AD user account. Inherits from directoryObject. Contains identity, profile, organizational, and authentication properties.",
  "allOf": [
    {
      "$ref": "#/components/schemas/DirectoryObject"
    }
  ],
  "properties": {
    "accountEnabled": {
      "type": "boolean",
      "description": "True if the account is enabled; otherwise, false.",
      "example": true
    },
    "assignedLicenses": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/AssignedLicense"
      },
      "description": "The licenses that are assigned to the user.",
      "readOnly": true,
      "example": []
    },
    "assignedPlans": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/AssignedPlan"
      },
      "description": "The plans that are assigned to the user.",
      "readOnly": true,
      "example": []
    },
    "businessPhones": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The telephone numbers for the user.",
      "example": []
    },
    "city": {
      "type": [
        "string",
        "null"
      ],
      "description": "The city where the user is located.",
      "example": "example_value"
    },
    "companyName": {
      "type": [
        "string",
        "null"
      ],
      "description": "The company name associated with the user.",
      "example": "example_value"
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "The country or region where the user is located.",
      "example": "example_value"
    },
    "createdDateTime": {
      "type": "string",
      "format": "date-time",
      "description": "The date and time the user was created.",
      "readOnly": true,
      "example": "2026-01-15T10:30:00Z"
    },
    "department": {
      "type": [
        "string",
        "null"
      ],
      "description": "The department in which the user works.",
      "example": "example_value"
    },
    "displayName": {
      "type": "string",
      "description": "The name displayed in the address book for the user. Required on creation.",
      "example": "example_value"
    },
    "employeeId": {
      "type": [
        "string",
        "null"
      ],
      "description": "The employee identifier assigned to the user by the organization.",
      "example": "500123"
    },
    "employeeType": {
      "type": [
        "string",
        "null"
      ],
      "description": "Captures the enterprise worker type. For example, Employee, Contractor, Consultant, or Vendor.",
      "example": "example_value"
    },
    "givenName": {
      "type": [
        "string",
        "null"
      ],
      "description": "The given name (first name) of the user.",
      "example": "example_value"
    },
    "jobTitle": {
      "type": [
        "string",
        "null"
      ],
      "description": "The user's job title.",
      "example": "example_value"
    },
    "mail": {
      "type": [
        "string",
        "null"
      ],
      "format": "email",
      "description": "The SMTP address for the user.",
      "example": "example_value"
    },
    "mailNickname": {
      "type": "string",
      "description": "The mail alias for the user. Required on creation.",
      "example": "example_value"
    },
    "mobilePhone": {
      "type": [
        "string",
        "null"
      ],
      "description": "The primary cellular telephone number for the user.",
      "example": "example_value"
    },
    "officeLocation": {
      "type": [
        "string",
        "null"
      ],
      "description": "The office location in the user's place of business.",
      "example": "example_value"
    },
    "onPremisesDistinguishedName": {
      "type": [
        "string",
        "null"
      ],
      "description": "The on-premises Active Directory distinguished name.",
      "readOnly": true,
      "example": "example_value"
    },
    "onPremisesDomainName": {
      "type": [
        "string",
        "null"
      ],
      "description": "The on-premises domain name.",
      "readOnly": true,
      "example": "example_value"
    },
    "onPremisesImmutableId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Used to associate an on-premises Active Directory user account to the Azure AD user object.",
      "example": "500123"
    },
    "onPremisesLastSyncDateTime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "The last time at which the object was synced with the on-premises directory.",
      "readOnly": true,
      "example": "2026-01-15T10:30:00Z"
    },
    "onPremisesSyncEnabled": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "True if this user object is currently being synced from an on-premises Active Directory.",
      "readOnly": true,
      "example": "example_value"
    },
    "otherMails": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "email"
      },
      "description": "Additional email addresses for the user.",
      "example": []
    },
    "passwordPolicies": {
      "type": [
        "string",
        "null"
      ],
      "description": "Specifies password policies for the user. One of DisableStrongPassword and DisablePasswordExpiration, or both.",
      "example": "example_value"
    },
    "postalCode": {
      "type": [
        "string",
        "null"
      ],
      "description": "The postal code for the user's postal address.",
      "example": "example_value"
    },
    "preferredLanguage": {
      "type": [
        "string",
        "null"
      ],
      "description": "The preferred language for the user in ISO 639-1 code format. Example: en-US.",
      "example": "example_value"
    },
    "proxyAddresses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The proxy addresses for the user. Example: SMTP:[email protected], smtp:[email protected].",
      "readOnly": true,
      "example": []
    },
    "signInSessionsValidFromDateTime": {
      "type": "string",
      "format": "date-time",
      "description": "Any refresh tokens or session tokens issued before this time are invalid.",
      "readOnly": true,
      "example": "2026-01-15T10:30:00Z"
    },
    "state": {
      "type": [
        "string",
        "null"
      ],
      "description": "The state or province in the user's address.",
      "example": "example_value"
    },
    "streetAddress": {
      "type": [
        "string",
        "null"
      ],
      "description": "The street address of the user's place of business.",
      "example": "example_value"
    },
    "surname": {
      "type": [
        "string",
        "null"
      ],
      "description": "The user's surname (family name or last name).",
      "example": "example_value"
    },
    "usageLocation": {
      "type": [
        "string",
        "null"
      ],
      "description": "A two-letter country code (ISO 3166). Required for users who will be assigned licenses.",
      "example": "example_value"
    },
    "userPrincipalName": {
      "type": "string",
      "description": "The user principal name (UPN) of the user. Required on creation. Format: alias@domain.",
      "example": "example_value"
    },
    "userType": {
      "type": [
        "string",
        "null"
      ],
      "description": "A string value that classifies the user. Typically Member or Guest.",
      "enum": [
        "Member",
        "Guest"
      ],
      "example": "Member"
    }
  }
}