Getting Started
Create an account
Sign up with your email. No credit card required for the 7-day trial.
Connect your Twitter accounts
Link your primary account and secondary accounts via OAuth2. Your passwords are never stored.
Configure automation
Set engagement percentages, AI content style, and rate limits in Settings.
Post from your primary account
Tweet normally. The system detects new posts within 5 minutes and triggers automation.
Monitor activity
Watch engagement roll in! Check the Activity page to see all automated actions.
Prerequisites
- • Twitter account (primary) where you post content
- • 1+ secondary Twitter accounts for engagement
- • That's it! The platform handles all Twitter API access for you
Authentication
X Automation Platform uses OAuth2 PKCE flow for secure Twitter account connections. We never see or store your Twitter password.
How OAuth2 Works
- Click "Connect Twitter Account" in the dashboard
- Choose "Primary" or "Secondary" account type
- You're redirected to Twitter's official login page
- Authorize X Automation Platform to access your account
- Redirected back with a secure access token
- Token is encrypted and stored in our database
Connecting Accounts
Primary Account
This is the account where you post original content. The system monitors this account for new tweets and triggers automation from your secondary accounts.
- • Only connect one primary account
- • This should be your main brand/personal account
- • The account you want to grow and amplify
Secondary Accounts
These accounts engage with your primary account's tweets (likes, retweets, replies).
- • Connect as many as you need (100-1000+ supported)
- • Use accounts you own or manage legitimately
- • Accounts should look real (profile pic, bio, some tweets)
- • Mix of follower counts looks more organic
Configuration
Automation Settings
Navigate to Dashboard → Settings to configure automation behavior.
Automation Status
Toggle to enable/disable all automation globally. When disabled, no actions are created or executed.
Max Actions Per Hour
Limit total automated actions per hour across all accounts. Default: 30. Safe range: 20-50.
Delay Between Actions
Time to wait between each action (in seconds). Adds randomness to avoid detection. Default: 60s.
Engagement Rates
Control what percentage of secondary accounts perform each action type.
AI Configuration
AI Model
Choose which OpenAI model to use for content generation:
- • GPT-4: Best quality, most contextual (recommended)
- • GPT-4 Turbo: Faster with similar quality
- • GPT-3.5 Turbo: Cheapest, good for high volume
Content Style
How AI generates comments and quote tweets:
- • Professional: Formal, business-appropriate
- • Casual: Friendly, conversational
- • Thought Leader: Insightful, strategic
- • Storytelling: Narrative-driven
- • Balanced: Mix of all styles
Smart Scaling (100+ Accounts)
When managing large numbers of accounts, smart scaling prevents detection and rate limits.
Limit how many secondary accounts engage with each tweet.
Default: 50 | Max: 10,000
Distribute actions over time instead of all at once.
Default: 2 hours | Max: 24 hours
Features
Automatic Tweet Detection
The system automatically detects new tweets from your primary account without any manual work.
- Polls every 5 minutes for new tweets from primary account
- Only processes original tweets (not retweets or replies)
- Client-side polling runs in your browser when dashboard is open
- Fallback to server polling via external cron service
Rate Limiting & Safety
Built-in safeguards prevent Twitter API rate limit violations and account suspensions.
Activity Monitoring
Track all automated actions in real-time from the Activity page.
Troubleshooting
Check:
- Is automation enabled in Settings?
- Are actions scheduled for the future?
- Click "Execute Pending Actions" button on Activity page
- Check for error messages on failed actions
Solution:
- Tokens refresh automatically, but if you see persistent errors:
- Go to Accounts page
- Click "Reconnect" on the affected account
- Re-authorize via OAuth2
What happens:
- Actions stay in PENDING status
- System waits for rate limit window to reset
- Actions retry automatically after reset
Prevention:
- Lower max actions per hour in Settings
- Increase spread engagement hours
- Reduce engagement percentages
Check:
- Is your primary account connected correctly?
- Have you posted an original tweet? (not a retweet or reply)
- Wait up to 5 minutes for polling to detect it
- Check browser console for polling errors
FAQ
How many accounts can I connect?▼
Unlimited. The platform is optimized for 100-1000+ accounts with smart scaling features.
Is my data secure?▼
Yes. We use OAuth2 (your password is never stored), encrypt all tokens, and follow security best practices. You can revoke access anytime from your Twitter account settings.
Will my accounts get banned?▼
When used responsibly with recommended settings, the risk is minimal. The platform includes rate limiting, account rotation, and time distribution to mimic organic behavior. However, always follow Twitter's Terms of Service and only manage accounts you own.
Can I pause automation temporarily?▼
Yes. Toggle the automation status in Settings to pause/resume all automation instantly.
Do I need to keep the dashboard open?▼
No. While client-side polling works when the dashboard is open, you should set up a server-side cron job (using services like cron-job.org or EasyCron) to poll the `/api/automation/poll` endpoint every 5 minutes.
Do I need my own Twitter Developer account?▼
No! The platform provides all Twitter API access. You only need to sign up for X Automation Platform and connect your Twitter accounts. We handle all the API complexity, keys, and rate limits for you.