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 EntraOpenID ConnectSAMLSCIMSingle Sign-OnZero Trust

Properties

Name Type Description
classification ['string', 'null'] Classification for the group (e.g., low, medium, high business impact).
createdDateTime string Timestamp of when the group was created.
description ['string', 'null'] An optional description for the group.
displayName string The display name for the group. Required on creation.
expirationDateTime ['string', 'null'] 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 ['boolean', 'null'] Indicates whether this group can be assigned to an Azure AD role. Can only be set at creation time.
mail ['string', 'null'] 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 ['string', 'null'] The rule that determines members for a dynamic group.
membershipRuleProcessingState ['string', 'null'] Indicates whether the dynamic membership processing is on or paused. On or Paused.
onPremisesDomainName ['string', 'null']
onPremisesLastSyncDateTime ['string', 'null']
onPremisesSyncEnabled ['boolean', 'null']
preferredLanguage ['string', 'null'] 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 ['string', 'null'] Security identifier (SID) of the group.
visibility ['string', 'null'] Specifies the group join policy and group content visibility. Public, Private, or HiddenMembership.
View JSON Schema on GitHub

JSON Schema

microsoft-graph-identity-group-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "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.",
  "properties": {
    "classification": {
      "type": "['string', 'null']",
      "description": "Classification for the group (e.g., low, medium, high business impact)."
    },
    "createdDateTime": {
      "type": "string",
      "description": "Timestamp of when the group was created."
    },
    "description": {
      "type": "['string', 'null']",
      "description": "An optional description for the group."
    },
    "displayName": {
      "type": "string",
      "description": "The display name for the group. Required on creation."
    },
    "expirationDateTime": {
      "type": "['string', 'null']",
      "description": "Timestamp of when the group is set to expire."
    },
    "groupTypes": {
      "type": "array",
      "description": "Specifies the group type. Include Unified for Microsoft 365 groups. Include DynamicMembership for dynamic groups."
    },
    "isAssignableToRole": {
      "type": "['boolean', 'null']",
      "description": "Indicates whether this group can be assigned to an Azure AD role. Can only be set at creation time."
    },
    "mail": {
      "type": "['string', 'null']",
      "description": "The SMTP address for the group."
    },
    "mailEnabled": {
      "type": "boolean",
      "description": "Specifies whether the group is mail-enabled. Required on creation."
    },
    "mailNickname": {
      "type": "string",
      "description": "The mail alias for the group, unique for Microsoft 365 groups. Required on creation."
    },
    "membershipRule": {
      "type": "['string', 'null']",
      "description": "The rule that determines members for a dynamic group."
    },
    "membershipRuleProcessingState": {
      "type": "['string', 'null']",
      "description": "Indicates whether the dynamic membership processing is on or paused. On or Paused."
    },
    "onPremisesDomainName": {
      "type": "['string', 'null']"
    },
    "onPremisesLastSyncDateTime": {
      "type": "['string', 'null']"
    },
    "onPremisesSyncEnabled": {
      "type": "['boolean', 'null']"
    },
    "preferredLanguage": {
      "type": "['string', 'null']",
      "description": "The preferred language for a Microsoft 365 group in ISO 639-1 format."
    },
    "proxyAddresses": {
      "type": "array"
    },
    "renewedDateTime": {
      "type": "string",
      "description": "Timestamp of when the group was last renewed."
    },
    "securityEnabled": {
      "type": "boolean",
      "description": "Specifies whether the group is a security group. Required on creation."
    },
    "securityIdentifier": {
      "type": "['string', 'null']",
      "description": "Security identifier (SID) of the group."
    },
    "visibility": {
      "type": "['string', 'null']",
      "description": "Specifies the group join policy and group content visibility. Public, Private, or HiddenMembership."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/microsoft-graph-identity-group"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.