Proxies are the backbone of safe Twitter automation. They protect your accounts from IP-based detection, distribute rate limits across different addresses, and help maintain account health.
In this guide, you'll learn how to add, manage, and assign proxies effectively in BotWitter, including bulk imports and auto-assignment strategies.
Why Proxies Matter
IP Protection
Each account uses a unique IP address, preventing mass bans when one account is flagged.
Rate Limit Distribution
Spread API requests across multiple IPs to avoid hitting rate limits on any single address.
Geographic Targeting
Use proxies from specific regions to match your account's supposed location.
Supported Proxy Formats
BotWitter supports multiple proxy string formats. Use whichever your provider supplies:
# Without authentication
192.168.1.1:8080
# With authentication (format 1)
192.168.1.1:8080:username:password
# With authentication (format 2)
username:password@192.168.1.1:8080
Proxy Types
HTTP/HTTPS
Most common type. Works for standard web traffic. Default choice for most providers.
SOCKS5
Lower-level protocol. Better for some use cases. Specify type when adding.
Adding Proxies
Single Proxy
Add individual proxies through the Proxies page or when editing an account:
- Navigate to Proxies in the sidebar
- Click "Add Proxy" button
- Enter proxy string in supported format
- Select proxy type (HTTP or SOCKS5)
- Click "Save"
Bulk Import
Import multiple proxies at once from a text list:
- Go to Proxies page
- Click "Bulk Import"
- Paste your proxy list (one per line)
- Click "Import"
# Example bulk import format:
user1:pass1@proxy1.example.com:8080
user2:pass2@proxy2.example.com:8080
192.168.1.10:3128:admin:secret
192.168.1.11:3128
Proxy Status & Health
BotWitter automatically monitors proxy health. Each proxy has one of these statuses:
Not yet checked
Currently testing
Ready to use
Failed check
Automatic Health Checks
Configure automatic proxy checking in Settings > Proxy:
How often to check proxy health (in minutes). Default: 30
Maximum accounts that can share one proxy. Default: 5
Proxy Assignment Strategies
BotWitter offers multiple ways to assign proxies to accounts:
1. Manual Assignment
Assign a specific proxy to an account by selecting from the proxy dropdown or entering a new proxy string.
PUT /accounts/{id}/proxy
{ "proxy": "192.168.1.1:8080:user:pass" }
2. Assign by Proxy ID
Reference an existing proxy in your pool by its ID.
PUT /accounts/{id}/proxy
{ "proxy_id": 123 }
3. Auto-Assign (Recommended)
Let BotWitter automatically assign an available working proxy from your pool. Respects the max_account_per_proxy limit.
PUT /accounts/{id}/proxy
{ "auto_assign": true }
4. Remove Proxy
Remove the proxy from an account (account will use direct connection).
PUT /accounts/{id}/proxy
{ "proxy": "" }
Proxy Pool Management
Filter and search your proxy pool to find specific proxies:
Filter Options
WORKING, NOT_WORKING, CHECKING, NONE
HTTP or SOCKS5
IP address or port number
Proxy Best Practices
Residential vs Datacenter
Residential proxies are more expensive but less likely to be detected. Datacenter proxies are cheaper but may trigger more captchas.
Sticky Sessions
Use sticky/static proxies for consistent IP. Rotating proxies can trigger security checks due to IP changes.
One Proxy Per Account
Ideally, each account should have its own proxy. Use max_account_per_proxy: 1 for best results.
Geographic Consistency
Match proxy location to account's supposed region. US account + German proxy = red flag.
Regular Health Checks
Enable automatic proxy checking. Dead proxies cause account failures and wasted time.
Don't Share Across Tools
Proxies used in other automation tools may be flagged. Use dedicated proxies for BotWitter.
Quick Recap
- Formats: ip:port, ip:port:user:pass, user:pass@ip:port
- Types: HTTP/HTTPS and SOCKS5 supported
- Bulk Import: Paste multiple proxies, one per line
- Auto-Assign: Let BotWitter pick available proxies automatically
- Health Checks: Automatic monitoring with configurable interval
- Best Practice: Use residential, sticky proxies with 1:1 account ratio