---
title: "Create folder in workspace"
method: POST
path: "/workspaces/{workspaceId}/folders"
tags: ["workspaces"]
---

# Create folder in workspace

`POST /workspaces/{workspaceId}/folders`

Creates a new folder in the workspace.

## Headers

- `Content-Type` 'application/json', required

## Request body

- FolderCreateRequest — A request body for creating or updating a folder.
  - `name` string — Folder name.

## Response `200`

Basic information about the created Folder.

- object
  - `message` 'SUCCESS' — Message that indicates the request was successful.
  - `resultCode` 0 — * '0' Success
  - `result` FolderListing
    - `id` number — Folder ID.
    - `name` string — Folder name.
    - `permalink` string — URL that represents a direct link to the folder in Smartsheet.

## Other responses

- `default` — Generic Error Payload

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)