---
title: "Service: /members/{member}/groups/{group}/folders/forurl [POST]"
source: https://dev.pageseeder.com/api/services/create-folder-forurl_post.html
description: "Creates a new folder under a specified destination in PageSeeder, supporting folder creation via parent URL or target URL with optional metadata including name, title, description, labels, and document ID."
last_updated: 2026-09-08T13:58:39+10:00
document_type: api_endpoint
operation_id: uri-POST
resource_id: uri
path_template: /members/{member}/groups/{group}/folders/forurl
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: ~432
---

# /members/\{member\}/groups/\{group\}/folders/forurl \[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 (required if url not specified) | maybe | string |  |
| parenturl | URL of parent URI (required if  url not specified) | maybe | url |  |
| url | URL of target URI (required if parenturl not specified) | maybe | url |  |
| 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) |