---
title: "Service: /groups/{group}/subgroups/add [POST]"
source: https://dev.pageseeder.com/api/services/add-subgroup-POST.html
description: "Adds a new subgroup to an existing group via POST request. Supports optional parameters for notification settings, role assignment, and member listing visibility, with required manager permissions."
last_updated: 2026-09-02T11:36:10+10:00
document_type: api_endpoint
operation_id: group-POST
resource_id: group
path_template: /groups/{group}/subgroups/add
http_method: POST
api_category: group
implementation_version: 6.3000
api_since: 5.4903
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~629
---

# /groups/\{group\}/subgroups/add \[POST\]

## Description

Adds a new [subgroup](../../reference/glossary/subgroup.md) in an existing group.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| subgroup | The `ID` or name of the group to add as a subgroup | yes | string |  |
| listed | Whether the member’s email address is listed in the group | no | enum | `inherit` |
| notification | The member’s notification option in the group | no | enum | `inherit` |
| role | The member’s role in the group | no | enum | `inherit` |

### `subgroup`

This parameter must be the `ID` or name of the group to add as a subgroup to the main group.

### `notification`

The notification parameter must be one of `immediate`, `essential`, `daily`, `weekly`, `none`, or `inherit`.

If not specified, the value `inherit` is used meaning that the members inherit the notification settings from the subgroup. 

### `role`

The role parameter must be one of `guest`, `reviewer`, `contributor`, `manager`, `approver` or `inherit`.

If not specified, the value `inherit` is used meaning that the members inherit the role from the subgroup. 

### `listed`

The listed boolean parameter can be used to override the group’s default setting. It affects whether other group members are able to see the subgroup’s members’ user details.

The supported values are `true`, `false` and `inherit`, the default value is `inherit` meaning that the members inherit the value from the subgroup. 

## Permission

This service requires manager or higher for both the group and the subgroup.

## Response

The XML response returns the created [\<subgroup\>](../elements/element_subgroup.md) element wrapping a [\<group\>](../elements/element_group.md) element acting as the subgroup.

```xml

<subgroup-addition>
  <subgroup id="[id]"
            role="[approver|
                   manager|
                   contributor|
                   reviewer|
                   guest|
                   inherit]"
            notification="[immediate|
                           daily|
                           none|
                           inherit]"
            listed="[true|false|inherit]">
    <group id="[group id]" name="[group name]" ../>
  </subgroup>
</subgroup-addition>
```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x1108 | Invalid group parameter |
| 0x1109 | Invalid notification parameter |
| 0x110A | Invalid role parameter |
| 0x110D | Subgroup already exists |