Twitter List Creator

What does Twitter List Creator do?

Twitter List Creator creates a Twitter/X list from an authenticated account using structured input. It is useful for audience segmentation, campaign preparation, and repeatable list creation workflows.

Built on the Apify platform, this Actor supports scheduling, webhooks, and dataset exports.

Why use Twitter List Creator?

• Audience segmentation - Create lists for research, engagement, or monitoring
• Campaign setup - Standardize list creation before downstream actions
• Operational visibility - Track list creation results in Apify datasets

How to use Twitter List Creator

1. Open the Actor on Apify
2. Enter the list settings and required authenticated session inputs
3. Start the run
4. Review the dataset output for success or error details

Input

This Actor accepts the fields required to create a Twitter/X list through an authenticated session.

Proxy object

Use the proxy object to define how requests should be routed. Common fields are:

• ip - Proxy host or endpoint URL
• port - Proxy port
• username - Proxy username
• password - Proxy password

Example input:

{
  "listName": "Founders To Watch",
  "listDescription": "Profiles for partnership and research workflows.",
  "isPrivateList": "true",
  "texAuVariables": {},
  "connectedAccountId": "example_connected_account_id",
  "auth_token": "example_auth_token",
  "ct0": "example_ct0_token",
  "kdt": "example_kdt_cookie",
  "twid": "u%3D1234567890",
  "user-agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36",
  "bearerToken": "AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAexampleBearerToken",
  "guest_token": "example_guest_token",
  "sec-ch-ua-platform": "\"Linux\"",
  "authorization": "Bearer AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAexampleBearerToken",
  "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36",
  "x-csrf-token": "example_ct0_token",
  "txSmSelfProfileUrl": "https://x.com/example_self_account",
  "proxy": {
    "ip": "http://proxy.example.com",
    "port": "1080",
    "username": "user_example|session_demo",
    "password": "example_proxy_password"
  }
}

Output

The Actor writes the action result to the default dataset.

Example output:

{
  "success": true,
  "response": {
    "listName": "Founders To Watch",
    "listDescription": "Profiles for partnership and research workflows.",
    "isPrivateList": true,
    "listCreated": true,
    "twListUrl": "https://x.com/i/lists/1234567890123456789",
    "timestamp": "2026-06-22T10:15:00.000Z"
  }
}

Pricing / Cost estimation

$0.00081 per successful API call on Apify.

Support

If you need adjustments for your workflow, use the Actor Issues tab or your internal support channel.