---
title: "Create a folder"
method: POST
path: "/folders"
---

# Create a folder

`POST /folders`

Requires scope `folder:write`.

## Request body

- object
  - `organizationId` string — DEPRECATED: use `teamId` instead.
  - `teamId` string — The team that the folder belongs to. If `teamId` is null, the folder will belong to the user directly.
  - `workspace` string — Slug of the workspace that the folder should be created in. The authenticated user must have access to this workspace.
  - `parentId` number — The parent folder that the folder belongs to.
  - `name` string, required — The name of the folder.

## Response `default`

Successful

---

[API](https://skmtc.dev/datawrapper/apis/datawrapper-api-v3-documentation.md) · [All operations](https://skmtc.dev/datawrapper/apis/datawrapper-api-v3-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datawrapper/datawrapper-api-v3-documentation/revisions/e190512863c7/schema)