---
title: "Create a folder"
method: POST
path: "/v1/design_studio/folders"
tags: ["Design Studio"]
---

# Create a folder

`POST /v1/design_studio/folders`

Create a new folder at the root level or under a parent folder. To create a child folder, you need the UUID of the parent folder, which you can retrieve with [List folders](/integrations/api/app/tag/design-studio/listFolders/).

## Request body

- object
  - `name` string, required — The name of the folder. Cannot contain these characters: < > : " / \ | ? * .
  - `parent_folder_id` string, uuid, nullable — UUID of the parent folder. Omit or pass `null` to create at root.

## Response `200`

Folder created

- object
  - `folder` Folder
    - `id` string, uuid — ID of folder
    - `name` string — The name of the folder.
    - `parent_folder_id` string, uuid, nullable — The ID of the parent folder. Returns `null` if there is no parent, which means the folder is in the root directory.
    - `created` integer — Timestamp of when the folder was created.
    - `updated` integer — Timestamp of last update to the folder.

## Other responses

- `400` — Bad request
- `401` — Unauthorized - missing or invalid API key
- `404` — Response not found

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)