---
title: "Create folder"
method: POST
path: "/home/folders"
tags: ["home"]
deprecated: true
---

# Create folder

`POST /home/folders`

> **Deprecated.**

Creates a new folder.

**DEPRECATED** - This endpoint is being removed. To adapt to this change, please see [Migrate from using the Sheets folder](/api/smartsheet/guides/updating-code/migrate-from-using-the-sheets-folder).

## Headers

- `Content-Type` string

## Request body

- Folder — Can contain dashboards, folders, reports, sheets, or templates.
  - `id` number — Folder ID.
  - `favorite` boolean — **Deprecated** Returned only if the user has marked the folder as a favorite in their "Home" tab (value = true).
  - `folders` Folder[] — Folders contained in folder.
  - `name` string — Folder name.
  - `permalink` string — URL that represents a direct link to the folder in Smartsheet.
  - `reports` GridListing[] — Reports contained in folder.
    - `id` number — Asset ID.
    - `name` string — Asset name.
    - `permalink` string — URL that represents a direct link to the asset in Smartsheet.
  - `sheets` GridListing[] — Sheets contained in folder.
    - `id` number — Asset ID.
    - `name` string — Asset name.
    - `permalink` string — URL that represents a direct link to the asset in Smartsheet.
  - `sights` DashboardListing[] — Dashboards contained in folder.
    - `id` number — Asset ID.
    - `name` string — Asset name.
    - `permalink` string — URL that represents a direct link to the asset in Smartsheet.
    - `createdAt` union
      - string, date-time
      - number
    - `modifiedAt` union
      - string, date-time
      - number
  - `templates` GridListing[] — Templates contained in folder.
    - `id` number — Asset ID.
    - `name` string — Asset name.
    - `permalink` string — URL that represents a direct link to the asset in Smartsheet.

## Response `200`

Result object containing a Folder object for newly created folder.

- object
  - `message` 'PARTIAL_SUCCESS' | 'SUCCESS' — Message that indicates the outcome of the request. (One of `SUCCESS` or `PARTIAL_SUCCESS`.)
  - `resultCode` 0 | 3 — * '0' Success * '3' Partial Success of Bulk Operation
  - `result` Folder — Can contain dashboards, folders, reports, sheets, or templates.
    - `id` number — Folder ID.
    - `favorite` boolean — **Deprecated** Returned only if the user has marked the folder as a favorite in their "Home" tab (value = true).
    - `folders` Folder[] — Folders contained in folder.
    - `name` string — Folder name.
    - `permalink` string — URL that represents a direct link to the folder in Smartsheet.
    - `reports` GridListing[] — Reports contained in folder.
      - `id` number — Asset ID.
      - `name` string — Asset name.
      - `permalink` string — URL that represents a direct link to the asset in Smartsheet.
    - `sheets` GridListing[] — Sheets contained in folder.
      - `id` number — Asset ID.
      - `name` string — Asset name.
      - `permalink` string — URL that represents a direct link to the asset in Smartsheet.
    - `sights` DashboardListing[] — Dashboards contained in folder.
      - `id` number — Asset ID.
      - `name` string — Asset name.
      - `permalink` string — URL that represents a direct link to the asset in Smartsheet.
      - `createdAt` union
        - string, date-time
        - number
      - `modifiedAt` union
        - string, date-time
        - number
    - `templates` GridListing[] — Templates contained in folder.
      - `id` number — Asset ID.
      - `name` string — Asset name.
      - `permalink` string — URL that represents a direct link to the asset 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)