---
title: "Create Folder from template"
method: POST
path: "/v2/space/{space_id}/folder_template/{template_id}"
tags: ["Folders"]
---

# Create Folder from template

`POST /v2/space/{space_id}/folder_template/{template_id}`

Create a new Folder using a Folder template within a Space. This endpoint allows you to create a folder with all its nested assets (lists, tasks, etc.) from a predefined template available in your Workspace. Publicly shared templates must be [added to your Workspace](https://help.clickup.com/hc/en-us/articles/6326023965591-Add-a-template-to-your-library) before you can use them with the public API.
This request can be run asynchronously or synchronously via the `return_immediately` parameter.

## Path parameters

- `space_id` string, required
- `template_id` string, required

## Request body

- object
  - `name` string, required — Name of the new Folder
  - `options` object — Options for creating the Folder
    - `return_immediately` boolean — Flag if newly created Object ID should be returned without waiting for the asset itself and all its nested assets to be applied. If set to true, access checks are performed before returning, but the object might not be fully created yet. In case of a timeout on syncronous requests, the of objects from the template will continue to be created past the timeout.
    - `content` string — List description
    - `time_estimate` boolean — Include time (hours, minutes and seconds)
    - `automation` boolean — Import automation options
    - `include_views` boolean — Import views
    - `old_due_date` boolean — Import tasks due dates
    - `old_start_date` boolean — Import tasks start dates
    - `old_followers` boolean — Import tasks watchers
    - `comment_attachments` boolean — Import tasks comment attachments
    - `recur_settings` boolean — Import tasks recurring settings
    - `old_tags` boolean — Import tasks tags
    - `old_statuses` boolean — Import tasks status settings
    - `subtasks` boolean — Import tasks subtasks
    - `custom_type` boolean — Import tasks types
    - `old_assignees` boolean — Import tasks assignees
    - `attachments` boolean — Import tasks attachments
    - `comment` boolean — Import tasks comments
    - `old_status` boolean — Import tasks current statuses
    - `external_dependencies` boolean — Import tasks external dependencies
    - `internal_dependencies` boolean — Import tasks internal dependencies
    - `priority` boolean — Import tasks priority
    - `custom_fields` boolean — Import tasks Custom Fields
    - `old_checklists` boolean — Import tasks checklists
    - `relationships` boolean — Import tasks relationships
    - `old_subtask_assignees` boolean — Import tasks subtasks and assignees combination
    - `start_date` string, date-time — Project start date for remapping dates
    - `due_date` string, date-time — Project due date for remapping dates
    - `remap_start_date` boolean — Remap start dates
    - `skip_weekends` boolean — Skip weekends when remapping dates
    - `archived` integer — Include archived tasks (1 or 2 or null)

## Response `200`

Folder created successfully

- object
  - `id` integer — ID of the created Folder
  - `folder` object
    - `id` string — Unique identifier of the Folder
    - `name` string — Name of the Folder
    - `orderindex` integer — Order index of the Folder
    - `override_statuses` boolean — Whether the Folder overrides default statuses
    - `hidden` boolean — Whether the Folder is hidden
    - `space` object
      - `id` string — ID of the Space containing the Folder
      - `name` string — Name of the Space
      - `access` boolean — Whether the user has access to the Space
    - `task_count` string — Number of tasks in the Folder
    - `archived` boolean — Whether the Folder is archived
    - `statuses` object[] — List of statuses available in the Folder
      - `id` string — Unique identifier of the status
      - `status` string — Name of the status
      - `orderindex` integer — Order index of the status
      - `color` string — Color code for the status
      - `type` string — Type of the status (closed, custom, open)
    - `lists` object[] — Lists contained in the Folder
    - `permission_level` string — Permission level for the current user

## Other responses

- `400` — Bad request - Name is required
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Template or space not found
- `500` — Internal server error

---

[API](https://skmtc.dev/clickup/apis/clickup-api-v2-reference.md) · [All operations](https://skmtc.dev/clickup/apis/clickup-api-v2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clickup/clickup-api-v2-reference/revisions/72216f55b952/schema)