---
title: "Create a list"
method: POST
path: "/lists"
tags: ["lists"]
---

# Create a list

`POST /lists`

Creates a new list for the authenticated account. The new list is not archived. `options` is an arbitrary key-value object stored on the list (used by callers to mark provenance, e.g. `source_type: 'ftp'`).

## Request body

- ListCreateBody — Body for POST /lists.
  - `name` string, required — Display name. Required, non-empty.
  - `description` string — Optional human-readable description.
  - `options` object — Arbitrary key-value attributes stored on the list (e.g. `{"source_type": "ftp"}`).

## Response `201`

List created

## Other responses

- `400` — Invalid body (missing or empty name)
- `401` — Unauthorized

---

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