Microsoft Azure Active Directory · Schema

Group

Represents an Azure AD group. Groups are collections of principals with shared access to resources. Microsoft Graph supports several types of groups: Microsoft 365 groups, security groups, and mail-enabled security groups.

AuthenticationAuthorizationIdentityMicrosoftMicrosoft EntraOAuthOpenID ConnectSAMLSCIMSingle Sign-OnZero Trust

Properties

Name	Type	Description
classification	stringnull	Classification for the group (e.g., low, medium, high business impact).
createdDateTime	string	Timestamp of when the group was created.
description	stringnull	An optional description for the group.
displayName	string	The display name for the group. Required on creation.
expirationDateTime	stringnull	Timestamp of when the group is set to expire.
groupTypes	array	Specifies the group type. Include Unified for Microsoft 365 groups. Include DynamicMembership for dynamic groups.
isAssignableToRole	booleannull	Indicates whether this group can be assigned to an Azure AD role. Can only be set at creation time.
mail	stringnull	The SMTP address for the group.
mailEnabled	boolean	Specifies whether the group is mail-enabled. Required on creation.
mailNickname	string	The mail alias for the group, unique for Microsoft 365 groups. Required on creation.
membershipRule	stringnull	The rule that determines members for a dynamic group.
membershipRuleProcessingState	stringnull	Indicates whether the dynamic membership processing is on or paused. On or Paused.
onPremisesDomainName	stringnull
onPremisesLastSyncDateTime	stringnull
onPremisesSyncEnabled	booleannull
preferredLanguage	stringnull	The preferred language for a Microsoft 365 group in ISO 639-1 format.
proxyAddresses	array
renewedDateTime	string	Timestamp of when the group was last renewed.
securityEnabled	boolean	Specifies whether the group is a security group. Required on creation.
securityIdentifier	stringnull	Security identifier (SID) of the group.
visibility	stringnull	Specifies the group join policy and group content visibility. Public, Private, or HiddenMembership.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/Group",
  "title": "Group",
  "type": "object",
  "description": "Represents an Azure AD group. Groups are collections of principals with shared access to resources. Microsoft Graph supports several types of groups: Microsoft 365 groups, security groups, and mail-enabled security groups.",
  "allOf": [
    {
      "$ref": "#/components/schemas/DirectoryObject"
    }
  ],
  "properties": {
    "classification": {
      "type": [
        "string",
        "null"
      ],
      "description": "Classification for the group (e.g., low, medium, high business impact).",
      "example": "example_value"
    },
    "createdDateTime": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp of when the group was created.",
      "readOnly": true,
      "example": "2026-01-15T10:30:00Z"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "An optional description for the group.",
      "example": "A sample description."
    },
    "displayName": {
      "type": "string",
      "description": "The display name for the group. Required on creation.",
      "example": "example_value"
    },
    "expirationDateTime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Timestamp of when the group is set to expire.",
      "example": "2026-01-15T10:30:00Z"
    },
    "groupTypes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specifies the group type. Include Unified for Microsoft 365 groups. Include DynamicMembership for dynamic groups.",
      "example": []
    },
    "isAssignableToRole": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indicates whether this group can be assigned to an Azure AD role. Can only be set at creation time.",
      "example": "example_value"
    },
    "mail": {
      "type": [
        "string",
        "null"
      ],
      "format": "email",
      "description": "The SMTP address for the group.",
      "readOnly": true,
      "example": "example_value"
    },
    "mailEnabled": {
      "type": "boolean",
      "description": "Specifies whether the group is mail-enabled. Required on creation.",
      "example": true
    },
    "mailNickname": {
      "type": "string",
      "description": "The mail alias for the group, unique for Microsoft 365 groups. Required on creation.",
      "example": "example_value"
    },
    "membershipRule": {
      "type": [
        "string",
        "null"
      ],
      "description": "The rule that determines members for a dynamic group.",
      "example": "example_value"
    },
    "membershipRuleProcessingState": {
      "type": [
        "string",
        "null"
      ],
      "description": "Indicates whether the dynamic membership processing is on or paused. On or Paused.",
      "example": "example_value"
    },
    "onPremisesDomainName": {
      "type": [
        "string",
        "null"
      ],
      "readOnly": true,
      "example": "example_value"
    },
    "onPremisesLastSyncDateTime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "readOnly": true,
      "example": "2026-01-15T10:30:00Z"
    },
    "onPremisesSyncEnabled": {
      "type": [
        "boolean",
        "null"
      ],
      "readOnly": true,
      "example": "example_value"
    },
    "preferredLanguage": {
      "type": [
        "string",
        "null"
      ],
      "description": "The preferred language for a Microsoft 365 group in ISO 639-1 format.",
      "example": "example_value"
    },
    "proxyAddresses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "readOnly": true,
      "example": []
    },
    "renewedDateTime": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp of when the group was last renewed.",
      "readOnly": true,
      "example": "2026-01-15T10:30:00Z"
    },
    "securityEnabled": {
      "type": "boolean",
      "description": "Specifies whether the group is a security group. Required on creation.",
      "example": true
    },
    "securityIdentifier": {
      "type": [
        "string",
        "null"
      ],
      "description": "Security identifier (SID) of the group.",
      "readOnly": true,
      "example": "example_value"
    },
    "visibility": {
      "type": [
        "string",
        "null"
      ],
      "description": "Specifies the group join policy and group content visibility. Public, Private, or HiddenMembership.",
      "enum": [
        "Public",
        "Private",
        "HiddenMembership"
      ],
      "example": "Public"
    }
  }
}