Create List

Create a list, $0.0005 per call.

Back to API Reference

/Lists Endpoints

TwexAPI REST

POST/twitter/list/create

Authorization

AuthorizationBearer token · headerrequired

Global API Bearer Token for TwexAPI. Included as: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Request Body

requiredapplication/json

cookiestringrequired

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_namestringrequired

The name of the list.

list_descriptionstringrequired

The description of the list.

is_privatebooleanrequired

Whether the list is private.

Responses

200A list object.

codeintegerrequired

The status code of the response.

msgstringrequired

The message of the response.

dataListModelrequired

The list object.

Show properties

idstringrequired

The ID of the list

namestringrequired

The name of the list

descriptionstringrequired

The description of the list

is_privatebooleanrequired

Whether the list is private

member_countintegerrequired

The number of members in the list

subscriber_countintegerrequired

The number of subscribers in the list

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

⚡Interactive Console / Try APIPOST/twitter/list/create

Live Console

🌐Target Server:https://api.twexapi.io

● Production Ready

✍️

Write Operation Credentials Guide (TwexAPI Key + Twitter Cookie)

1. TwexAPI Platform Key (Bearer Token): Enter under "API Authorization" below for request billing & authentication.

2. Twitter Account Cookie: For write operations (tweet, like, follow, etc.), provide the target Twitter account's Cookie (e.g. auth_token=...; ct0=...) in the cookie field of Request Body below.

🔑API Authorization

Remember keySync to code samples

TwexAPI Platform Key Bearer TokenRequired

Global API key used across all TwexAPI endpoints. Get it from the console.

📝Request Bodyapplication/json

cookiestringTwitter Account Cookie / Auth Token

RequiredThe 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_namestring

RequiredThe name of the list.

list_descriptionstring

RequiredThe description of the list.

is_privateboolean

RequiredWhether the list is private.

💡 Quick send:⌘ / Ctrl+Enter

📡

No Response Yet

Configure parameters in the Request tab and click Send Request below.

Request

curl -X POST "https://api.twexapi.io/twitter/list/create" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "list_name": "string",
  "list_description": "string",
  "is_private": true
}'

const response = await fetch("https://api.twexapi.io/twitter/list/create", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "list_name": "string",
  "list_description": "string",
  "is_private": true
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/list/create",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "list_name": "string",
  "list_description": "string",
  "is_private": True
},
)

Response

{
  "code": 0,
  "msg": "string",
  "data": {
    "id": "string",
    "name": "string",
    "description": "string",
    "is_private": true,
    "member_count": 0,
    "subscriber_count": 0
  }
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}