---
title: "Create secure space or folder"
method: POST
path: "/api/1/folders"
tags: ["Secure spaces & folders"]
---

# Create secure space or folder

`POST /api/1/folders`

## Request body

- object
  - `name` string, required — Must not be greater than 255 characters.
  - `secured_space` boolean, nullable
  - `scope` 'private' | 'public', nullable
  - `parent` integer, nullable
  - `parent_url` string, nullable
  - `copy_permissions_from_parent` boolean, nullable
  - `template` integer, nullable
  - `copy-contents` integer, nullable
  - `emails` string[], required — Must be a valid email address.
  - `message` string, nullable
  - `priority` integer, nullable
  - `show_preview` boolean, 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)