---
title: "Service: /members/{member}/groups/{group}/folders [POST]"
source: https://dev.pageseeder.com/api/services/create-folder-POST.html
description: "Creates a new folder within a specified member group. Requires contributor permissions and accepts optional parameters for parent folder location, display title, description, and labels. Invalid filenames are automatically corrected."
last_updated: 2026-09-02T11:36:12+10:00
document_type: api_endpoint
operation_id: uri-POST
resource_id: uri
path_template: /members/{member}/groups/{group}/folders
http_method: POST
api_category: uri
implementation_version: 6.2004
api_since: 3.3000
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~536
---

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

## Description

Creates a new [folder](../../reference/glossary/folder.md) under the specified destination.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| name | Name of folder to create | yes | string |  |
| parentfolder | Name of parent folder in the default group folder | no | string | `/` |
| description | Description of new folder | no | string |  |
| docid | Folder `ID` | no | string |  |
| labels | Comma-separated list of folder label values | no | label |  |
| title | Display title of new folder. Max 255 characters | no | string |  |

## Permission

This service requires contributor or higher.

## Response

The XML output follows this format:

```xml

<folder-creation [renamed="true" original-name="new:folder"]>
  <uri id="138614"
       scheme="https"
       host="localhost"
       port="443"
       folder="true"
       path="/ps/jb/group1/documents/new_folder"
       decodedpath="/ps/jb/group1/documents/new_folder"
       external="false"
       mediatype="folder"
       created="2013-12-19T15:14:54+11:00">
    <displaytitle>New folder</displaytitle>
  </uri>
</folder-creation> 
```

If name is invalid, it is changed automatically to a character valid, the return is:

```xml

<folder-creation renamed="true" original-name="ne,/.\@dcdd">
  <uri id="97" 
       scheme="http" 
       host="localhost"
       port="80" 
       path="/ps/pub/a/ne%2C_._%40dcdd" 
       decodedpath="/ps/pub/a/ne,_._@dcdd"
       external="false" 
       mediatype="folder" 
       created="2017-02-27T08:24:47+11:00"
       modified="2017-02-27T08:24:47+11:00">
    <displaytitle>ne,_._@dcdd</displaytitle>
  </uri>
</folder-creation>
```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x1201 | Illegal character in filename |
| 0x1216 | Invalid destination |
| 0x120A | Invalid Document ID |
| 0x1209 | Existing Document ID |
| 0x1211 | Existing URI |
| 0x1217 | Two contradictory parameters have been specified (url and name or url and parenturl or url and parentfolder or parenturl and parentfolder) |