extensionProperty resource type

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

Allows an application to define and use a set of additional properties that can be added to directory objects (users, groups, tenant details, devices, applications, and service principals) without the application requiring an external data store. For more information about extension properties, see Azure AD Graph API Directory Schema Extensions. Inherits from directoryObject.

JSON representation

Here is a JSON representation of the resource

  "appDisplayName": "string",
  "dataType": "string",
  "id": "string (identifier)",
  "isSyncedFromOnPremises": true,
  "name": "string",
  "targetObjects": ["string"]


Property Type Description
appDisplayName String
dataType String Specifies the type of the directory extension property being added. Supported types are: Integer, LargeInteger, DateTime (must be specified in ISO 8601 - DateTime is stored in UTC), Binary, Boolean, and String.
isSyncedFromOnPremises Boolean Indicates whether the extension property is synced from the on premises directory. Notes: not nullable.
name String Specifies the display name for the directory extension property. Notes: not nullable.
id String The unique identifier for the permission scope. Inherited from directoryObject. Notes: key, immutable, not nullable, unique. Read-only.
targetObjects String collection The directory objects to which the directory extension property is being added. Supported directory entities that can be extended are: “User”, “Group”, “organization”, “Device”, “Application” and “ServicePrincipal” Notes: not nullable.




Method Return Type Description
Get extensionProperty extensionProperty Read properties and relationships of extensionProperty object.
Update extensionProperty extensionProperty Update extensionProperty object.
Delete extensionProperty None Delete extensionProperty object.
checkMemberGroups String collection
getMemberGroups String collection
getMemberObjects String collection