---
title: "Add a new list to the board"
method: POST
path: "/v1/boards/{boardId}/lists.json"
tags: ["lists"]
---

# Add a new list to the board

`POST /v1/boards/{boardId}/lists.json`

Created a List for board

## Path parameters

- `boardId` integer, required

## Query parameters

- `token` string, required

## Request body

- object
  - `board_id` integer
  - `is_archived` boolean
  - `name` string
  - `position` integer
  - `uuid` string

## Response `200`

successful operation

- object
  - `id` integer
  - `created` string
  - `modified` string
  - `board_id` integer
  - `user_id` integer
  - `name` string
  - `position` integer
  - `is_archived` boolean
  - `card_count` integer
  - `is_deleted` boolean
  - `lists_subscriber_count` integer
  - `custom_fields` string
  - `color` string
  - `activities` object
    - `id` string
    - `created` string
    - `modified` string
    - `board_id` integer
    - `list_id` integer
    - `card_id` integer
    - `user_id` integer
    - `foreign_id` integer
    - `type` string
    - `comment` string
    - `revisions` string
    - `root` integer
    - `freshness_ts` string
    - `depth` integer
    - `path` string
    - `materialized_path` string
    - `organization_id` integer
    - `board_name` string
    - `list_name` string
    - `card_name` string
    - `username` string
    - `full_name` string
    - `profile_picture_path` string
    - `initials` string
    - `label_name` string
    - `card_description` string
    - `user_role_id` integer
    - `checklist_item_name` string
    - `checklist_item_parent_name` string
    - `checklist_name` string
    - `organization_name` string
    - `organization_logo_url` string
    - `moved_list_name` string
    - `created_time` string
    - `card_position` string
    - `comment_count` integer

## Other responses

- `405` — Invalid input

---

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