Microsoft Entra ID (formerly Azure AD)

Microsoft Entra ID (formerly Azure AD) Groups.group API

The groups.group API from Microsoft Entra ID (formerly Azure AD) — 4 operation(s) for groups.group.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /groups List groups in the organization · List groups #
Ask an LLM
“How do I list all the groups in my Entra ID tenant?”
“Can I search or filter groups by display name when listing them?”
Tell an agent
List all groups in the organization.
Find groups whose display name matches {search}.
POST /groups Create a group · Create group #
Ask an LLM
“How do I create a new security group in Entra ID?”
“What do I need to set to create a Microsoft 365 group with a mail nickname?”
Tell an agent
Create a security group called {displayName} with mail nickname {mailNickname}.
Create a new group {displayName} described as {description}.
GET /groups/{group-id} Get a group by id · Get group #
Ask an LLM
“How do I get the properties of a group when I know its object id?”
“Which group properties are returned by default, and how do I ask for others?”
Tell an agent
Get group {group}.
Show the display name, mail and visibility of group id {group}.
PATCH /groups/{group-id} Update a group by id · Upsert group #
Ask an LLM
“How do I rename a group or change its description using its object id?”
“Can I change a group's visibility after it's been created?”
Tell an agent
Rename group {group} to {displayName}.
Set the visibility of group id {group} to {visibility}.
DELETE /groups/{group-id} Delete a group by id · Delete group #
Ask an LLM
“Can a deleted group be restored, and for how long?”
“How do I delete a group using its object id?”
Tell an agent destructive · confirm first
Delete group {group}.
Remove the group with object id {group} from the tenant.
GET /groups(uniqueName='{uniqueName}') Get a group by its unique name · Get group #
Ask an LLM
“Can I look up a group by its uniqueName instead of its object id?”
“What does the group with a given unique name look like?”
Tell an agent
Get the group with unique name {uniqueName}.
Look up group by unique name {uniqueName} and show its properties.
PATCH /groups(uniqueName='{uniqueName}') Upsert a group by its unique name · Upsert group #
Ask an LLM
“How do I create a group only if one with this unique name doesn't already exist?”
“Can I upsert a group keyed on uniqueName so reruns don't create duplicates?”
Tell an agent
Upsert the group with unique name {uniqueName} and display name {displayName}.
Create or update group {uniqueName} with description {description}.
DELETE /groups(uniqueName='{uniqueName}') Delete a group by its unique name · Delete group #
Ask an LLM
“Is it possible to delete a group addressing it by uniqueName rather than id?”
“What happens to a distribution group when I delete it by unique name?”
Tell an agent destructive · confirm first
Delete the group with unique name {uniqueName}.
Remove group {uniqueName}, identified by its unique name.
GET /groups/$count Count groups · Get the number of the resource #
Ask an LLM
“How many groups are there in my organization?”
“Do I need the ConsistencyLevel header to get a group count?”
Tell an agent
Count all groups in the tenant.
Give me the total number of groups.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview
📖
Authentication
https://learn.microsoft.com/en-us/graph/auth/
📖
Documentation
https://learn.microsoft.com/en-us/graph/change-notifications-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-groups-group-api-openapi.yml

Other Resources

🔗
SDKs
https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
🔗
ChangeLog
https://developer.microsoft.com/en-us/graph/changelog
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/asyncapi/azure-ad-change-notifications-webhooks.yml

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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 API 
curl "https://apis.io/api/v1/apis/azure-ad:azure-ad-groups-group-api"
All apis 
curl "https://apis.io/api/v1/apis?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.

GitHub Google LinkedIn

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

OpenAPI Specification

azure-ad-groups-group-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Groups.group API
  version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
  description: Core
security:
- azureaadv2: []
tags:


# --- truncated at 32 KB (731 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-groups-group-api-openapi.yml