---
title: "Create List"
method: POST
path: "/twitter/list/create"
tags: ["Lists Endpoints"]
---

# Create List

`POST /twitter/list/create`

## Request

- Base URL: `https://api.twexapi.io`
- URL: `https://api.twexapi.io/twitter/list/create`
- Auth: HTTP bearer

Create a list, $0.0005 per call.

## Request body

- CreateListQuery
  - `cookie` string, required: The user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).
  - `list_name` string, required: The name of the list.
  - `list_description` string, required: The description of the list.
  - `is_private` boolean, required: Whether the list is private.

## Response `200`

A list object.

- CreateListResponse
  - `code` integer, required: The status code of the response.
  - `msg` string, required: The message of the response.
  - `data` ListModel, required
    - `id` string, required: The ID of the list
    - `name` string, required: The name of the list
    - `description` string, required: The description of the list
    - `is_private` boolean, required: Whether the list is private
    - `member_count` integer, required: The number of members in the list
    - `subscriber_count` integer, required: The number of subscribers in the list

## Other responses

- `422`: Validation Error

---

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