twitter_list_create
Create a new Twitter/X List with a name, description, and privacy setting. Returns the new list ID for adding members later.
Instructions
Create a new Twitter/X List owned by YOUR registered X session, with a name and an optional description and privacy flag. This is the starting point for building a List from code: create it here, then fill it with twitter_list_add_member using the list id this returns. Returns ok, action, the new list_id, member_count, and the full list object X returned. A List is PUBLIC unless you explicitly ask for a private one, and a private List is not readable by the public List read tools (twitter_list_members, twitter_list_tweets, twitter_list_timeline).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ct0 | No | Optional. The account's ct0 cookie, paired with auth_token. Sent as the x-ct0 header. | |
| name | Yes | Display name for the new List, e.g. "Founders". Required; an empty or whitespace-only name is rejected with a 400. | |
| proxy_url | No | Optional. Residential proxy URL to egress this call through. Recommended for writes: X soft-blocks writes from datacenter IPs as automated. Sent as the x-proxy-url header. | |
| auth_token | No | Optional. The account's auth_token cookie, to act AS that account for this call (must be paired with ct0). Sent as the x-auth-token header; never placed in the URL. | |
| is_private | No | Optional. Pass the string "true" to create a PRIVATE List. Defaults to false (public), because a public List can be made private later while a leak cannot be undone. Note a private List is not readable by the public List read tools. | |
| user_agent | No | Optional. User-Agent string to send for this session. Sent as the x-user-agent header. | |
| description | No | Optional. Description shown on the List, e.g. "People building in public". Defaults to empty. |