microsoft-active-directory-groups

Active Directory Groups — manage security and Microsoft 365 groups, members, owners, and transitive membership

Server path: /microsoft-active-directory-groups | Type: Application | PCID required: Yes

Tools

Tool	Description
microsoft_active_directory_groups_add_group_member	Add a member to a group
microsoft_active_directory_groups_add_group_owner	Add an owner to a group
microsoft_active_directory_groups_create_group	Create a new group
microsoft_active_directory_groups_delete_group	Delete a group
microsoft_active_directory_groups_get_group	Get a group by ID
microsoft_active_directory_groups_list_group_members	List group members
microsoft_active_directory_groups_list_group_owners	List group owners
microsoft_active_directory_groups_list_group_transitive_members	List transitive members of a group
microsoft_active_directory_groups_list_groups	List groups
microsoft_active_directory_groups_remove_group_member	Remove a member from a group
microsoft_active_directory_groups_remove_group_owner	Remove an owner from a group
microsoft_active_directory_groups_update_group	Update a group

---

microsoft_active_directory_groups_add_group_member

Add a member to a group

Parameters:

Parameter	Type	Required	Default	Description
group_id	string	Yes	—	Group ID (GUID)
member_url	string	Yes	—	Full URL of the directory object to add (e.g. https://graph.microsoft.com/v1.0/users/{user-id})

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "group_id": {
      "type": "string",
      "description": "Group ID (GUID)"
    },
    "member_url": {
      "type": "string",
      "description": "Full URL of the directory object to add (e.g. https://graph.microsoft.com/v1.0/users/{user-id})"
    }
  },
  "required": [
    "PCID",
    "group_id",
    "member_url"
  ]
}

---

microsoft_active_directory_groups_add_group_owner

Add an owner to a group

Parameters:

Parameter	Type	Required	Default	Description
group_id	string	Yes	—	Group Id
owner_url	string	Yes	—	Full URL of the owner (e.g. https://graph.microsoft.com/v1.0/users/{user-id})

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "group_id": {
      "type": "string",
      "description": "Group Id"
    },
    "owner_url": {
      "type": "string",
      "description": "Full URL of the owner (e.g. https://graph.microsoft.com/v1.0/users/{user-id})"
    }
  },
  "required": [
    "PCID",
    "group_id",
    "owner_url"
  ]
}

---

microsoft_active_directory_groups_create_group

Create a new group

Parameters:

Parameter	Type	Required	Default	Description
description	string	No	—	Description of the group
displayName	string	Yes	—	Display name of the group
groupTypes	string[]	No	—	Set to [‘Unified’] for Microsoft 365 groups, or [] for security groups
mailEnabled	boolean	Yes	—	Whether the group is mail-enabled
mailNickname	string	Yes	—	Mail alias for the group
securityEnabled	boolean	Yes	—	Whether the group is a security group

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "description": {
      "type": "string",
      "description": "Description of the group"
    },
    "displayName": {
      "type": "string",
      "description": "Display name of the group"
    },
    "groupTypes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Unified",
          "DynamicMembership"
        ]
      },
      "description": "Set to ['Unified'] for Microsoft 365 groups, or [] for security groups"
    },
    "mailEnabled": {
      "type": "boolean",
      "description": "Whether the group is mail-enabled"
    },
    "mailNickname": {
      "type": "string",
      "description": "Mail alias for the group"
    },
    "securityEnabled": {
      "type": "boolean",
      "description": "Whether the group is a security group"
    }
  },
  "required": [
    "PCID",
    "displayName",
    "mailEnabled",
    "mailNickname",
    "securityEnabled"
  ]
}

---

microsoft_active_directory_groups_delete_group

Delete a group

Parameters:

Parameter	Type	Required	Default	Description
group_id	string	Yes	—	Group ID (GUID)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "group_id": {
      "type": "string",
      "description": "Group ID (GUID)"
    }
  },
  "required": [
    "PCID",
    "group_id"
  ]
}

---

microsoft_active_directory_groups_get_group

Get a group by ID

Parameters:

Parameter	Type	Required	Default	Description
group_id	string	Yes	—	Group ID (GUID)
$select	string	No	—	Comma-separated list of properties to return

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "group_id": {
      "type": "string",
      "description": "Group ID (GUID)"
    },
    "$select": {
      "type": "string",
      "description": "Comma-separated list of properties to return"
    }
  },
  "required": [
    "PCID",
    "group_id"
  ]
}

---

microsoft_active_directory_groups_list_group_members

List group members

Parameters:

Parameter	Type	Required	Default	Description
group_id	string	Yes	—	Group ID (GUID)
$select	string	No	—	Comma-separated list of properties to return
$top	integer	No	—	Number of results to return

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "group_id": {
      "type": "string",
      "description": "Group ID (GUID)"
    },
    "$select": {
      "type": "string",
      "description": "Comma-separated list of properties to return"
    },
    "$top": {
      "type": "integer",
      "description": "Number of results to return"
    }
  },
  "required": [
    "PCID",
    "group_id"
  ]
}

---

microsoft_active_directory_groups_list_group_owners

List group owners

Parameters:

Parameter	Type	Required	Default	Description
group_id	string	Yes	—	Group Id
$top	integer	No	—	The $top value

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "group_id": {
      "type": "string",
      "description": "Group Id"
    },
    "$top": {
      "type": "integer",
      "description": "The $top value"
    }
  },
  "required": [
    "PCID",
    "group_id"
  ]
}

---

microsoft_active_directory_groups_list_group_transitive_members

List transitive members of a group

Parameters:

Parameter	Type	Required	Default	Description
group_id	string	Yes	—	Group Id
$top	integer	No	—	The $top value

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "group_id": {
      "type": "string",
      "description": "Group Id"
    },
    "$top": {
      "type": "integer",
      "description": "The $top value"
    }
  },
  "required": [
    "PCID",
    "group_id"
  ]
}

---

microsoft_active_directory_groups_list_groups

List groups

Parameters:

Parameter	Type	Required	Default	Description
$filter	string	No	—	OData filter expression (e.g. “displayName eq ‘Marketing’“)
$select	string	No	—	Comma-separated list of properties to return
$top	integer	No	—	Number of results to return
$orderby	string	No	—	Order results (e.g. “displayName asc”)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "$filter": {
      "type": "string",
      "description": "OData filter expression (e.g. \"displayName eq 'Marketing'\")"
    },
    "$select": {
      "type": "string",
      "description": "Comma-separated list of properties to return"
    },
    "$top": {
      "type": "integer",
      "description": "Number of results to return"
    },
    "$orderby": {
      "type": "string",
      "description": "Order results (e.g. \"displayName asc\")"
    }
  },
  "required": [
    "PCID"
  ]
}

---

microsoft_active_directory_groups_remove_group_member

Remove a member from a group

Parameters:

Parameter	Type	Required	Default	Description
group_id	string	Yes	—	Group ID (GUID)
member_id	string	Yes	—	ID of the member to remove

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "group_id": {
      "type": "string",
      "description": "Group ID (GUID)"
    },
    "member_id": {
      "type": "string",
      "description": "ID of the member to remove"
    }
  },
  "required": [
    "PCID",
    "group_id",
    "member_id"
  ]
}

---

microsoft_active_directory_groups_remove_group_owner

Remove an owner from a group

Parameters:

Parameter	Type	Required	Default	Description
group_id	string	Yes	—	Group Id
owner_id	string	Yes	—	ID of the owner to remove

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "group_id": {
      "type": "string",
      "description": "Group Id"
    },
    "owner_id": {
      "type": "string",
      "description": "ID of the owner to remove"
    }
  },
  "required": [
    "PCID",
    "group_id",
    "owner_id"
  ]
}

---

microsoft_active_directory_groups_update_group

Update a group

Parameters:

Parameter	Type	Required	Default	Description
group_id	string	Yes	—	Group ID (GUID)
description	string	No	—	The description value
displayName	string	No	—	Display Name
mailNickname	string	No	—	Mail Nickname
membershipRule	string	No	—	Membership Rule
membershipRuleProcessingState	string	No	—	Membership Rule Processing State
visibility	string	No	—	The visibility value

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "group_id": {
      "type": "string",
      "description": "Group ID (GUID)"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "displayName": {
      "type": "string",
      "description": "Display Name"
    },
    "mailNickname": {
      "type": "string",
      "description": "Mail Nickname"
    },
    "membershipRule": {
      "type": "string",
      "description": "Membership Rule"
    },
    "membershipRuleProcessingState": {
      "type": "string",
      "description": "Membership Rule Processing State",
      "enum": [
        "On",
        "Paused"
      ]
    },
    "visibility": {
      "type": "string",
      "description": "The visibility value"
    }
  },
  "required": [
    "PCID",
    "group_id"
  ]
}