---
title: "Create List View"
method: POST
path: "/v2/list/{list_id}/view"
tags: ["Views"]
---

# Create List View

`POST /v2/list/{list_id}/view`

Add a List, Board, Calendar, Table, Timeline, Workload, Activity, Map, Chat, or Gantt view to a List.

## Path parameters

- `list_id` number, required

## Request body

- object
  - `name` string, required
  - `type` string, required — The type of view to create. Options include: `list`, `board`, `calendar`, `table`, `timeline`, `workload`, `activity`, `map`, `conversation`, or `gantt`.
  - `grouping` Grouping, required — unresolved $ref
  - `divide` Divide, required — unresolved $ref
  - `sorting` Sorting, required — unresolved $ref
  - `filters` Filters, required — unresolved $ref
  - `columns` Columns, required — unresolved $ref
  - `team_sidebar` TeamSidebar, required — unresolved $ref
  - `settings` Settings, required — unresolved $ref

## Response `200`

- object
  - `view` View, required — unresolved $ref

---

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