---
title: "Create Folderless List"
method: POST
path: "/v2/space/{space_id}/list"
tags: ["Lists"]
---

# Create Folderless List

`POST /v2/space/{space_id}/list`

Add a new List in a Space.

## Path parameters

- `space_id` number, required

## Request body

- object
  - `name` string, required
  - `content` string
  - `markdown_content` string — Use `markdown_content` instead of `content` to format your List description.
  - `due_date` integer
  - `due_date_time` boolean
  - `priority` integer
  - `assignee` integer — Include a `user_id` to add a List owner.
  - `status` string — **Status** refers to the List color rather than the task Statuses available in the List.

## Response `200`

- object
  - `id` string
  - `name` string
  - `orderindex` integer
  - `content` string
  - `status` Status — unresolved $ref
  - `priority` Priority — unresolved $ref
  - `assignee` object
    - `id` integer, required
    - `color` string, required
    - `username` string, required
    - `initials` string, required
    - `profilePicture` string, required
  - `task_count` string, nullable
  - `due_date` string
  - `due_date_time` boolean
  - `start_date` string, nullable
  - `start_date_time` string, nullable
  - `folder` Folder — unresolved $ref
  - `space` Space — unresolved $ref
  - `statuses` Status[] — unresolved $ref
  - `inbound_address` string

---

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