> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`](#microsoft_active_directory_groups_add_group_member)                           | Add a member to a group            |
| [`microsoft_active_directory_groups_add_group_owner`](#microsoft_active_directory_groups_add_group_owner)                             | Add an owner to a group            |
| [`microsoft_active_directory_groups_create_group`](#microsoft_active_directory_groups_create_group)                                   | Create a new group                 |
| [`microsoft_active_directory_groups_delete_group`](#microsoft_active_directory_groups_delete_group)                                   | Delete a group                     |
| [`microsoft_active_directory_groups_get_group`](#microsoft_active_directory_groups_get_group)                                         | Get a group by ID                  |
| [`microsoft_active_directory_groups_list_group_members`](#microsoft_active_directory_groups_list_group_members)                       | List group members                 |
| [`microsoft_active_directory_groups_list_group_owners`](#microsoft_active_directory_groups_list_group_owners)                         | List group owners                  |
| [`microsoft_active_directory_groups_list_group_transitive_members`](#microsoft_active_directory_groups_list_group_transitive_members) | List transitive members of a group |
| [`microsoft_active_directory_groups_list_groups`](#microsoft_active_directory_groups_list_groups)                                     | List groups                        |
| [`microsoft_active_directory_groups_remove_group_member`](#microsoft_active_directory_groups_remove_group_member)                     | Remove a member from a group       |
| [`microsoft_active_directory_groups_remove_group_owner`](#microsoft_active_directory_groups_remove_group_owner)                       | Remove an owner from a group       |
| [`microsoft_active_directory_groups_update_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\&#125](https://graph.microsoft.com/v1.0/users/\{user-id\&#125);) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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/\&#123;user-id\&#125](https://graph.microsoft.com/v1.0/users/\&#123;user-id\&#125);) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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                                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## microsoft\_active\_directory\_groups\_delete\_group

Delete a group

**Parameters:**

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

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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                  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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")                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>

***

## 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             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "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"
    ]
  }
  ```
</Expandable>