---
title: "Create a folder / secure space"
method: POST
path: "/api/2/folders"
tags: ["Secure spaces, folders & files"]
---

# Create a folder / secure space

`POST /api/2/folders`

## Request body

- object
  - `name` string, required — Must be at least 1 character. Must not be greater than 255 characters.
  - `parents` integer[], required
  - `secured_space` boolean, nullable — Options.
  - `visibility` 'private' | 'public', nullable
  - `create_folder_policy` 'external' | 'internal', nullable
  - `permissions_source` 'parent', nullable — Creation options.
  - `content_source` 'template' | 'folder', nullable — This field is required when <code>content_source_id</code> is present.
  - `content_source_id` integer, nullable — This field is required when <code>content_source</code> is present.
  - `message` string, nullable — Sharing.
  - `message_priority` integer, nullable
  - `message_preview` 'notification', nullable
  - `shares` object[]
    - `email` string, required — Must be a valid email address.
    - `message` string, nullable
    - `message_priority` integer, nullable
    - `message_preview` 'notification', nullable

## Response `200`

- object
  - `ID` integer
  - `@type` string
  - `@id` string
  - `Access` string
  - `Link` string
  - `OriginalLink` string
  - `URL` string
  - `created_at` string
  - `deleted_at` string, nullable
  - `expires_at` string, nullable
  - `updated_at` string
  - `creator` object
    - `ID` integer
    - `@type` string
    - `Title` string, nullable
    - `Name` string
    - `FirstName` string
    - `LastName` string
    - `Avatar` string
    - `Scope` string
    - `HasContact` boolean
  - `Scope` string
  - `Name` string
  - `SecuredSpace` boolean
  - `MessagesMode` integer
  - `CreateFolderPolicy` string, nullable

---

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