---
title: "Service: /members/{member}/groups [POST]"
source: https://dev.pageseeder.com/api/services/create-group-POST.html
description: "Creates a new group within a PageSeeder project. Requires contributor access in the parent project and mandatory parameters: description, projectname, and shortname. Supports customization of access, commenting, moderation, and member defaults."
last_updated: 2026-09-02T11:36:11+10:00
document_type: api_endpoint
operation_id: group-POST
resource_id: group
path_template: /members/{member}/groups
http_method: POST
api_category: group
implementation_version: 6.3000
api_since: 5.4101
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~807
---

# /members/\{member\}/groups \[POST\]

## Description

Creates a [group](../../reference/glossary/group.md) in PageSeeder.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| description | Description of group | yes | string |  |
| projectname | Parent project name | yes | string |  |
| shortname | Shortname of group | yes | string |  |
| access | Access to group and comments  (admin only) `[public\|member]` | no | string | `member` |
| addmember | Whether to add the current member as a manager | no | boolean | `true` |
| commenting | Who can comment `[public\|reviewer\|contributor]` | no | string | `reviewer` |
| common | Whether this is a common group. *DEPRECATED in PageSeeder v5.99.* | no | boolean | `false` |
| createdocuments | Whether to create default documents | no | boolean | `true` |
| defaultnotify | Default notification for new members `[immediate\|daily\|none]` | no | string | `immediate` |
| defaultrole | Default role for new members `[reviewer\|contributor]` | no | string | `reviewer` |
| detailstype | The name of the member details config file (admin or project manager only) | no | string |  |
| editurls | Allow contributors in this group to edit all URLs on the server (admin only) | no | boolean | `false` |
| message | Subscription message | no | string |  |
| moderation | Which comments are to be moderated `[reviewer\|email\|all]` | no | string | `reviewer` |
| owner | Owner of group (admin only) | no | string | \[project owner\] |
| property.\* | Value for group property named `*` | no | string |  |
| registration | Self-registration method `[normal\|moderated\|confirmed]` | no | string | `normal` |
| relatedurl | URL of a related website | no | string |  |
| template | The template folder for customizations (admin only) | no | string |  |
| title | The user friendly title of group. Max 255 characters | no | string |  |
| visibility | Group name this is visible to or `public` (admin only) | no | string | \[projectname-shortname\] |

## Permission

Requires contributor or higher in the parent project.

## Response

```xml

<group|project-creation>
  <group|project id="123"
                 name="myproject-mygroup"
                 [title="My group"]
                 description="My own group"
                 owner="My Organisation"
                 access="[public| member]"
                 common="[true|false]"
                 [relatedurl="http://mycompany/mypage.html"]
                 [visibility="myproject-mygroup"]
                 [template="myproject"]
                 [detailstype="mydetails"]
                 editurls="[true|false]"
                 commenting="[public|reviewer|contributor]"
                 moderation="[none|reviewer|email|all]"
                 registration="[normal|moderated|confirmed]"
                 defaultrole="[reviewer|contributor]" 
                 defaultnotify="[immediate|daily|none]" >
    <message>Welcome to the group!</message>
  </group|project>
</group|project-creation>
```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x110C | The projectname must be specified, or is invalid |
| 0x0201 | Missing required shortname and description |