Connect your Reddit accounts to SubPirate Pro using secure OAuth authentication. Once connected, you can use these accounts for automated posting campaigns, track karma and post statistics, and manage account health.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/MatthewSabia1/SubPirate-Pro/llms.txt
Use this file to discover all available pages before exploring further.
Connecting Reddit Accounts
SubPirate Pro uses Reddit’s official OAuth 2.0 flow to connect accounts securely:Navigate to Reddit Accounts
From the main menu, go to the Reddit Accounts page. You’ll see all your connected accounts or an empty state if none are connected yet.
Authorize on Reddit
You’re redirected to Reddit’s official authorization page. Log in to the Reddit account you want to connect.SubPirate Pro requests the following permissions:
- identity: Read your username and account info
- submit: Create posts on your behalf
- read: Read posts and comments
- history: Access your post history
OAuth tokens are encrypted using AES-256-GCM and stored securely. SubPirate Pro never sees or stores your Reddit password.
Account Dashboard
Each connected account displays:Account Card Header
- Avatar: Profile picture (from Reddit or custom uploaded)
- Username: Clickable link to your Reddit profile (u/username)
- Badges:
- Premium: Gold badge if you have Reddit Premium
- Mod: Green badge if you moderate any subreddits
- Verified: Blue checkmark if email verified
Account Statistics
Karma
Total karma score with breakdown tooltip:
- Link Karma
- Comment Karma
- Awardee Karma
- Awarder Karma
Total Posts
Number of posts in your history (up to last 100 fetched).
Posts Today
Number of posts made in the last 24 hours. Updates when account data is refreshed.
- Green indicator if > 0 posts today
- Gray indicator if 0 posts today
Action Buttons
Expand/Collapse Click the chevron icon to view or hide the account’s post history. Refresh- Manually refresh account data
- Updates karma, post counts, and fetches latest posts
- Shown as spinning icon while refreshing
- Remove account from SubPirate Pro
- Revokes OAuth tokens
- Account can be reconnected later if needed
Account Avatars
Default Avatar
When you connect an account:- If Reddit provides an avatar URL, it’s used automatically
- Otherwise, a unique generated avatar is created based on the username
Custom Avatar Upload
Click Upload Icon
Click the upload icon and select an image file from your device.Requirements:
- Image file (JPEG, PNG, GIF, WebP)
- Maximum size: 2MB
- Square images work best (will be cropped to fit)
Removing Custom Avatar
Post History
Expand any account to view post history with two tabs:Most Recent Posts
Shows the last posts made by this account (up to 100): Each post displays:- Thumbnail: Post image or subreddit icon
- Title: Post title (clickable to Reddit)
- Upvotes: Score (upvotes minus downvotes)
- Comments: Number of comments
- Date: When the post was created
- Subreddit: Which subreddit (r/subredditname)
Top Posts
Shows the account’s top-scoring posts (sorted by score):- Same information as recent posts
- Sorted by highest score first
- Useful for understanding what content performs well
- Identifies your most successful posts for reference
Refreshing Post Data
Automatic Refresh On page load, accounts are batch-refreshed in the background:- Processes 2 accounts at a time
- 3-second delay between batches
- Prevents rate limiting
- Accounts currently being viewed are skipped
- Clears cached post data
- Fetches fresh posts from Reddit
- Updates karma and post counts
- Shows refreshing indicator
- Viewing posts within 5 minutes uses cached data (instant)
- After 5 minutes, data is refetched automatically
- Cache age displayed in the post header (“Cached 2 min ago”)
Using Accounts in Campaigns
Connected accounts can be selected as posting sources in campaigns:Account Selection
Account Health in Campaigns
Once an account is used in a campaign, its health status is tracked:Healthy
Status: GreenAccount is posting successfully with no recent failures.
- Consecutive failures: 0
- Can post without restrictions
Warning
Status: Yellow1-2 consecutive posting failures detected.
- Posting continues normally
- Watch for recurring issues
- May escalate to Error if failures continue
Error
Status: Orange2+ consecutive failures.
- Posting continues but with caution
- Review error messages in campaign run logs
- Fix underlying issues to prevent disabling
Disabled
Status: Red3+ consecutive failures. Account is temporarily disabled.Cooldown periods:
- 3 failures: 5 minutes
- 4 failures: 30 minutes
- 5+ failures: 120 minutes
Account Limits and Best Practices
Reddit Rate Limits
Reddit imposes API rate limits:- OAuth rate limit: 60 requests per minute per account
- Posting rate limit: ~5-10 posts per day per account (varies by subreddit and account age)
- Karma requirements: Some subreddits require minimum karma to post
- Queuing campaign runs with built-in delays
- Rotating through multiple accounts
- Implementing exponential backoff on errors
- Disabling accounts on repeated failures
Account Age and Karma
New Reddit accounts have restrictions:- Many subreddits require accounts to be 30+ days old
- Minimum karma requirements vary (100 to 1000+ common)
- Low-karma accounts may be shadowbanned in some communities
- 60+ days of age
- 500+ combined karma
- Email verification completed
- Some organic post history
Number of Accounts
Free Plan: Connect up to 3 Reddit accounts Pro Plan: Connect up to 10 Reddit accounts Enterprise Plan: Unlimited accountsUsing multiple accounts helps distribute posting load and reduces the chance of rate limiting or account restrictions.
Security and Privacy
Token Storage
Reddit OAuth tokens are stored securely:- Encryption: AES-256-GCM encryption
- Key management: Encryption keys stored separately from data
- Access control: Only you can access your connected accounts
- Revocation: Deleting an account revokes all tokens
What SubPirate Pro Can Do
With the granted permissions, SubPirate Pro can:- ✅ Read your username and account info
- ✅ Create posts on your behalf (only when you trigger campaigns)
- ✅ Read your post and comment history
- ❌ Cannot read your private messages
- ❌ Cannot change account settings
- ❌ Cannot vote on posts
- ❌ Cannot send messages or chat
Revoking Access
To revoke SubPirate Pro’s access: Option 1: Delete from SubPirate Pro- Go to Reddit Accounts page
- Click delete button on the account
- Confirm deletion
- Tokens are revoked and deleted
- Go to reddit.com/prefs/apps
- Find “SubPirate Pro” in authorized apps
- Click “revoke access”
- SubPirate Pro can no longer access this account
Troubleshooting
Connection Failed
Symptoms: Redirected to Reddit but then back to SubPirate Pro with an error. Causes:- Reddit OAuth app not configured correctly
- Invalid redirect URI
- Reddit API outage
- Try connecting again (temporary glitch)
- Check that you’re logged into the correct Reddit account
- Verify your email on Reddit (required for OAuth)
- Contact support if problem persists
Account Not Refreshing
Symptoms: Clicking refresh doesn’t update karma or posts. Causes:- Reddit API rate limit reached
- Account was recently refreshed (cooldown)
- Reddit API error
- Wait 1-2 minutes and try again
- Check if Reddit is experiencing outages
- Try refreshing a different account first
Posts Not Showing
Symptoms: Account shows 0 posts, but you know there are posts. Causes:- Account has no public posts
- Posts are deleted or removed
- Reddit API not returning post history
- Verify posts are visible on reddit.com/user/[username]
- Check if account is shadowbanned (post to r/ShadowBan)
- Try disconnecting and reconnecting the account
Campaign Posts Failing
Symptoms: Campaigns using this account show failures. Causes:- Account doesn’t meet subreddit requirements
- Account is rate limited or restricted by Reddit
- Content violates subreddit rules
- Account tokens expired or revoked
- Check account health status in campaign Accounts tab
- Review error messages in campaign run logs
- Verify account meets karma and age requirements for target subreddits
- Try reconnecting the account to refresh tokens
- Test posting manually on Reddit to ensure account works
Best Practices
Diversify Accounts
Use multiple accounts with varied histories:
- Different creation dates
- Different karma levels
- Different posting patterns
Build Authentic History
Before using accounts for campaigns:
- Make organic posts and comments
- Engage genuinely in communities
- Build karma naturally
- Establish a posting history
Monitor Health
Regularly check account health:
- Review post history for removed posts
- Watch for repeated failures in campaigns
- Address warnings before accounts are disabled
- Keep accounts in “Healthy” status
Rotate Usage
Don’t overuse a single account:
- Spread posts across multiple accounts
- Use campaigns to automatically rotate
- Give accounts rest periods
- Vary posting times and patterns
Respect Reddit
Follow Reddit’s rules and culture:
- Don’t spam
- Provide value in posts
- Follow subreddit-specific guidelines
- Engage authentically even when promoting
Account Management Tips
Organizing Multiple Accounts
- Custom avatars: Upload unique avatars to quickly identify accounts
- Naming convention: Use Reddit usernames that indicate their purpose (e.g., u/BrandName_Official)
- Campaign assignment: Assign accounts to specific campaigns based on their karma and history
Maintaining Account Health
- Weekly reviews: Check account stats weekly
- Karma growth: Ensure karma is growing (accounts used only for promotion may decline)
- Post diversity: Don’t use accounts only for campaign posts; mix in organic content
- Engagement: Comment and participate, not just post
Scaling Your Strategy
- Start with 1-2 accounts: Test and refine your approach
- Add accounts gradually: As you prove success, connect more accounts
- Upgrade plans: Increase account limits with Pro or Enterprise plans
- Monitor performance: Track which accounts perform best in which subreddits
- Optimize assignments: Assign high-karma accounts to strict subreddits, new accounts to lenient ones