---
title: "POST /papersign/folders"
method: POST
path: "/papersign/folders"
tags: ["Papersign Folders"]
---

# POST /papersign/folders

`POST /papersign/folders`

This endpoint returns a creates a new Papersign folder.
Please note that this feature is exclusively available as part of the [Papersign API](https://paperform.co/products/papersign/#pricing).

## Request body

- PapersignFolderCreate
  - `name` string, required — The new name of the folder.
  - `space_id` number — The unique identifier of the space to create the folder in.
  - `path` string — The path to create the folder in. Maximum depth is 4 levels. Any missing folders will also be created.
  - `folder_id` number — The unique identifier of the folder to create the folder in. Required when space_id and path are not present.

## Response `200`

Successfully created a new Papersign Folder

- object
  - `status` 'ok'
  - `results` object
    - `folder` PapersignFolder
      - `id` number — The unique identifier of the folder.
      - `name` string, required — The name of the document.
      - `parent_id` number, nullable — The unique identifier of the parent folder.
      - `space_id` number — The unique identifier of the space.

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized
- `403` — Not Permitted
- `404` — Not Found
- `422` — Validation Error
- `429` — Too Many Requests
- `5XX` — Unexpected Error

---

[API](https://skmtc.net/paperform/apis/paperform-api.md) · [All operations](https://skmtc.net/paperform/apis/paperform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paperform/paperform-api/versions/dc1e62b7063d/schema)