---
title: "Create List"
method: POST
path: "/list/create"
tags: ["Write Actions"]
---

# Create List

`POST /list/create`

## Request

- Base URL: `https://api.twitterapis.com/twitter`
- URL: `https://api.twitterapis.com/twitter/list/create`
- Auth: HTTP bearer

Create a List owned by your registered X session, with a name and an optional description and privacy flag. Populate it afterwards with Add List Member. Cost: $0.0016 per call.

## Request body

- object
  - `name` string, required: Display name for the new List.
  - `description` string: Optional description shown on the List.
  - `is_private` boolean: Whether the List is private. Private Lists are not readable by the public List read endpoints.

## Response `200`

Create a new Twitter/X List owned by your session.

- object
  - `ok` boolean: True when the List was created.
  - `list` object: The List object X returned, including its new numeric id.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Insufficient credits
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited
- `5XX`: Server error

---

[API](https://skmtc.dev/twitterapis/apis/twitterapis-api.md) · [All operations](https://skmtc.dev/twitterapis/apis/twitterapis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twitterapis/apis/twitterapis-api/revisions/a33ce0fedb3c?raw)