---
title: "Service: /members/{member}/groups/{group}/uris/{uri}/folders [POST]"
source: https://dev.pageseeder.com/api/services/create-folder-foruri_post.html
description: "Creates a new folder under a specified URI destination with customizable name, description, labels, and title. Requires contributor permissions or higher."
last_updated: 2026-09-08T12:19:09+10:00
document_type: api_endpoint
operation_id: uri-POST
resource_id: uri
path_template: /members/{member}/groups/{group}/uris/{uri}/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: ~383
---

# /members/\{member\}/groups/\{group\}/uris/\{uri\}/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 |  |
| description | Description of new folder | no | string |  |
| docid | Folder `ID` | no | string |  |
| labels | Comma-separated list of folder label values | no | string |  |
| title | Display title of new folder | 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> 
```

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