Campaigns

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.

Campaigns are automated posting workflows that schedule and execute Reddit posts across multiple subreddits using your connected accounts. Each campaign can target specific subreddit and account combinations, with intelligent scheduling and health monitoring.

​

Campaign Overview

A campaign consists of:

• Account Targets: Which Reddit accounts will be used for posting
• Subreddit Targets: Which subreddits will receive posts
• Content Versions: What content will be posted (title, body, media)
• Schedule Settings: When and how often posts are made
• Run History: Record of all execution attempts and results

​

Creating a Campaign

​

Campaign Configuration

After creating a campaign, configure it using the tabbed interface:

​

Overview Tab

​

Campaign Settings

• Name: Edit the campaign name
• Objective: Update the campaign goal
• Status: Change between Draft, Active, Paused, Completed
• Daily Post Target: Adjust posts per day (1-100)
• Start/End Dates: Modify campaign duration
• Description: Add strategic notes

​

Autopost Readiness

A visual checklist showing what’s needed for the campaign to run:

​

Active Content Configuration

Configure the content that will be posted: Post Type

• Text (self): Text post with title and body
• Link: URL post with title and optional body
• Image: Image post (requires media from Media Library)
• Video: Video post (requires media from Media Library)

Title (required): The post title. Use variables and templates from subreddit analysis. Body (optional): Post body text. Markdown formatting supported. Link URL: Required for link posts, optional for image/video as fallback. Media Rotation Mode: How media assets are selected (currently only “Sequential” supported). Click “Save New Content Version” to create a new version. The latest version is automatically activated.

​

Accounts Tab

Select which Reddit accounts will be used for posting:

​

Account Health and Cooldowns

The campaign system automatically manages account health:

• After 1 failure: Status changes to “Warning”, posting continues
• After 2 failures: Status changes to “Error”, posting continues with caution
• After 3 failures: Account disabled for 5 minutes
• After 4 failures: Account disabled for 30 minutes
• After 5+ failures: Account disabled for 120 minutes

Healthy posting resets the failure count to 0 and restores “Healthy” status.

​

Subreddit Targets

On the Accounts tab, you’ll also configure subreddit targets:

​

Account-Subreddit Pairing

The campaign creates all possible combinations of your selected accounts and subreddits: Example:

• 3 selected accounts (u/account1, u/account2, u/account3)
• 2 selected subreddits (r/subreddit1, r/subreddit2)
• Result: 6 pairings:
  • u/account1 → r/subreddit1
  • u/account1 → r/subreddit2
  • u/account2 → r/subreddit1
  • u/account2 → r/subreddit2
  • u/account3 → r/subreddit1
  • u/account3 → r/subreddit2

When the campaign runs, it rotates through these pairings to distribute posts evenly.

​

Members Tab

Manage team collaboration on this campaign:

​

Inviting Members

​

Campaign Roles

​

Runs Tab

View and manage campaign execution history:

​

Run History List

All campaign runs are listed with:

• Run Type: Manual (user-triggered) or Scheduled (automatic)
• Status:
  • Queued: Waiting to execute
  • Running: Currently posting
  • Completed: Finished successfully
  • Failed: Errors prevented completion
  • Canceled: Stopped before completion
• Timestamps: When scheduled, started, and ended
• Attempt Metrics: Target, executed, failed, skipped
• Shortfall: Number of posts below target

Click any run to view detailed attempt logs and events.

​

Run Detail View

When you select a run, you see: Run Summary

• Configuration snapshot (what settings were active)
• Overall success/failure metrics
• Timing information

Attempt List Each posting attempt shows:

• Account used (username)
• Subreddit target
• Content version
• Status (posted, failed, skipped, deduped)
• Error messages (if failed)
• Reddit post ID (if successful)
• Retry count

Event Log Detailed timeline of run execution:

• Run started/ended events
• Account health changes
• Posting successes/failures
• Pause/resume actions
• System warnings

Events include severity levels (info, warning, error) and detailed payloads for debugging.

​

Settings Tab

Advanced campaign configuration: Timezone Set the timezone for campaign scheduling (IANA format, e.g., “America/New_York”). Determines when “daily” resets and posting times. Jitter Seconds Randomize posting times by up to this many seconds. Helps posts appear more natural (e.g., 300 = ±5 minutes). Carry-Over Enabled If enabled, unmet daily post targets carry over to the next day. If disabled, each day starts fresh. Pause Requested (Read-only, set via campaign status) Indicates if the campaign should pause after the current run completes.

​

Running Campaigns

​

Manual Runs

Trigger a campaign run immediately: Run Prevents You cannot run if:

• No account targets selected
• No subreddit targets selected
• No active content version created
• Daily post target already met (0 attempts needed)

​

Automated Scheduling

Campaigns with status “Active” run automatically: How It Works

1. Scheduler: A cron job runs every minute (Vercel cron at /api/internal/campaigns/dispatch)
2. Eligibility Check: Looks for campaigns that:
   • Have status “Active”
   • Have not requested pause
   • Are within start/end date range
   • Have not met today’s post target
   • Have no queued or running executions
3. Queue Run: Creates a campaign run with status “Queued”
4. Execute: Run processes attempts in sequence, posting to Reddit via connected accounts
5. Update Metrics: Campaign run records success/failure counts and shortfall

Daily Reset At midnight in the campaign’s configured timezone:

• Posts today counter resets to 0
• Shortfall from previous day carries over (if carry-over enabled)
• New runs scheduled to meet daily target

​

Pause and Resume

Pausing Resuming

​

Content Versioning

Campaigns support multiple content versions:

​

Creating Versions

Each time you click “Save New Content Version” in the Overview tab:

1. Deactivate Previous: The currently active version is marked inactive
2. Increment Version: A new version number is assigned (1, 2, 3, etc.)
3. Activate New: The new version becomes active immediately
4. Snapshot Saved: All content details are stored with the version

​

Version History

All versions are preserved. You can:

• View all past versions in the campaign detail
• See which version was used for each campaign run
• Understand how content evolved over time
• (Future) Reactivate old versions

​

Active Version

Only one content version can be active at a time:

• Active version is used for all new campaign runs
• Run history shows which version was active when that run executed
• Changing active version doesn’t affect queued runs (they use snapshot)

​

Media Library Integration

For image and video campaigns, link media assets from the Media Library: Media is Optional Even for image/video post types:

• If no media is linked, the link_url field is used as fallback
• The post becomes a link post instead of direct media
• This allows flexibility in content strategy

​

Campaign Metrics

The campaigns dashboard shows aggregate metrics:

​

Per-Campaign Metrics

Each campaign card shows:

• Status Badge: Visual indicator of campaign state
• Date Range: Start to end date
• Daily Target: Posts per day
• Linked Assets: Number of media items attached
• Queued Runs: Pending executions for this campaign
• Shortfall: Unmet posts from yesterday
• Unhealthy Accounts: Problem accounts in this campaign

​

Troubleshooting Campaigns

​

Campaign Won’t Run

Check Readiness

• Verify all 4 readiness checks are green in the Overview tab
• Ensure status is “Active” and not “Paused”
• Confirm start date is today or in the past
• Check that daily post target isn’t already met

Check Scheduling

• Campaign runs every minute if conditions are met
• Manual runs bypass scheduling checks
• Look at run history to see if runs are being created but failing

​

Posts Failing

Account Issues

• Check account health status on Accounts tab
• If disabled, wait for cooldown to expire
• Verify Reddit account is still connected in Reddit Accounts page
• Ensure account has sufficient karma for target subreddits

Content Issues

• Verify content meets subreddit rules (check analysis)
• Ensure media URLs are accessible if using image/video posts
• Check that link URLs are valid and not blacklisted
• Review error messages in run attempt logs

​

High Shortfall

Causes

• Not enough account/subreddit pairings to meet daily target
• Accounts frequently hitting cooldowns or errors
• Subreddit restrictions preventing posts
• Posts being removed quickly (appears as success, but isn’t)

Solutions

• Add more account targets
• Add more subreddit targets
• Reduce daily post target
• Review and fix content to comply with subreddit rules
• Check Reddit account standing (shadowbanned?)

​

Campaign Best Practices

​

Example Campaign Setup

Goal: Launch a new SaaS product to tech communities