Twitter People List Builder

What does Twitter People List Builder do?

Twitter People List Builder adds people to an existing Twitter/X list from an authenticated account. It is useful for audience curation, workflow automation, and list maintenance tasks that need repeatable execution.

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

Why use Twitter People List Builder?

• List management - Add profiles into an existing Twitter/X list in a repeatable way
• Audience operations - Maintain curated lists for monitoring or outreach workflows
• Structured output - Store run results in Apify datasets for auditing

How to use Twitter People List Builder

1. Open the Actor on Apify
2. Enter the target list details, people inputs, and authenticated session fields
3. Start the run
4. Review the dataset output for action results

Input

This Actor accepts the fields required to add people to 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:

{
  "listId": "1234567890123456789",
  "twitterUsers": [
    "example_user_one",
    "example_user_two"
  ],
  "auth_token": "example_auth_token",
  "ct0": "example_ct0_token",
  "twid": "u=123456789",
  "user-agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36",
  "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_csrf_token",
  "txSmSelfProfileUrl": "https://x.com/example_self",
  "texAuVariables": {},
  "proxy": {
    "ip": "http://proxy.example.com",
    "port": "1080",
    "username": "user_example|session_demo",
    "password": "example_proxy_password"
  }
}

Output

The Actor writes the list update result to the default dataset.

Example output:

{
  "success": true,
  "response": {
    "listId": "1234567890123456789",
    "addedUsers": [
      "example_user_one",
      "example_user_two"
    ],
    "timestamp": "2026-06-24T08:00:00.000Z"
  }
}

Pricing / Cost estimation

$0.00081 per successful API call on Apify.

Failed requests are not charged under the primary pricing event.

Support

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