---
title: "addLists()"
method: POST
path: "/lists"
tags: ["list"]
---

# addLists()

`POST /lists`

## Query parameters

- `key` string, required
- `token` string, required

## Request body

- Lists
  - `closed` string — true or false
  - `idBoard` string — id of the board that the list should be added to
  - `idListSource` string — The id of the list to copy into a new list.
  - `name` string — a string with a length from 1 to 16384
  - `pos` string — A position. top , bottom , or a positive number.
  - `subscribed` string — true or false

## Response `200`

Success

## Other responses

- `400` — Server rejection

## Changes

- **2017-03-21** (1.0) `74afdba5e145` — 3 info
  - the endpoint scheme security `api_key` was added to the API
  - the endpoint scheme security `api_token` was added to the API
  - the endpoint scheme security `trello_auth` was removed from the API

[Change history](https://skmtc.dev/apis-guru/apis/trello/changes/lists/post.md)

---

[API](https://skmtc.dev/apis-guru/apis/trello.md) · [All operations](https://skmtc.dev/apis-guru/apis/trello/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apis-guru/trello/revisions/74afdba5e145/schema)