---
title: "Create List"
method: POST
path: "/api/list"
tags: ["List"]
---

# Create List

`POST /api/list`

Create a new list.<br><br>*Rate limit*:<br>Limit: 150<br>TTL: 60s

**Scopes:**
`list:manage`

## Headers

- `revision` string, required

## Request body

- CreateListDto
  - `data` DataObject, required
    - `type` 'list' | 'subscriber', required
    - `attributes` AttributesObject, required
      - `name` string, required — A helpful name to label the list

## Response `200`

Create New List

- List
  - `isDefaultStoreList` boolean, required
  - `name` string, required
  - `starred` boolean, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `5XX`
- `4XX`

---

[API](https://skmtc.net/bespoke/apis/bespoke-rest-api.md) · [All operations](https://skmtc.net/bespoke/apis/bespoke-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bespoke/bespoke-rest-api/revisions/cdd7c62eba0a/schema)