---
title: "Create a folder"
method: POST
path: "/v1/assets/folders"
tags: ["Assets"]
---

# Create a folder

`POST /v1/assets/folders`

Creates a new folder for organizing file assets. Folder names must be unique within the same parent folder.

## Request body

- object
  - `name` string, required — Display name for the folder. Must be unique among siblings in the same parent folder.
  - `parent_folder_id` integer, nullable — The ID of the parent folder. Omit or set to "0" to create at the root level.

## Response `200`

The newly created folder.

- object
  - `folder` Folders
    - `id` integer — The unique identifier of the folder.
    - `name` string — The display name of the folder.
    - `parent_folder_id` integer, nullable — The ID of the parent folder, or null if the folder is at the root level.
    - `created` integer — Unix timestamp when the folder was created.
    - `updated` integer — Unix timestamp when the folder was last updated.

## Other responses

- `400` — Bad request
- `401` — Unauthorized - missing or invalid API key
- `404` — Resource not found
- `409` — Conflict - linked resource or other constraint violation

---

[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)