Scheduling & Publishing Posts

Genie Helper’s post scheduler automatically publishes queued content to your connected platforms. It runs every 60 seconds, checking for posts scheduled to go live.

How the Scheduler Works

Architecture

Worker Responsibilities

Polling: Checks scheduled_posts collection every 60 seconds
Due Detection: Finds posts where scheduled_time <= NOW() and status = 'queued'
Job Creation: Creates media_jobs with operation: 'publish_post'
Platform Dispatch: Uses Stagehand to automate platform-specific posting workflows
Status Updates: Marks posts as published or failed after completion

Scheduling Your First Post

Prepare Your Content

Before scheduling, make sure you have:

Media file: Image, video, or audio uploaded to /app/media
Caption: Written text (or generate with AI — see AI Captions guide)
Platform connection: At least one platform connected in /app/platforms

Open the Scheduling Interface

Option 1: Via Media Library

Go to /app/media
Click on a media item to open the detail view
Click Schedule Post button

Option 2: Via AI Chat Widget

Click the chat icon (bottom-right)

Type:

Schedule my latest OnlyFans photo for tomorrow at 6 PM with caption "New content dropping 🔥"

Genie will create the scheduled post for you

Option 3: Direct API (for developers)

curl -X POST https://geniehelper.com/api/directus/items/scheduled_posts \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "onlyfans",
    "media_id": "abc-123-media-uuid",
    "caption": "New content 🔥",
    "scheduled_time": "2026-03-10T18:00:00Z",
    "status": "queued"
  }'

Fill Out Post Details

In the scheduling modal, enter:Platform: Select target platform (OnlyFans, Fansly, Instagram, etc.)Media: Select one or more files from your libraryCaption: Enter your post text (max 5000 characters)Scheduled Time: Pick date and time (uses your browser’s timezone, converted to UTC on save)Tags (optional): Add platform-specific hashtags or tagsPrice (optional): For paid content platforms (OnlyFans PPV, Fansly tiers, etc.)

Click 'Schedule Post'

The system:

Creates a scheduled_posts record:

{
  "id": "post-uuid-123",
  "platform": "onlyfans",
  "media_id": "media-abc-456",
  "caption": "New content 🔥",
  "scheduled_time": "2026-03-10T18:00:00.000Z",
  "status": "queued",
  "creator_profile_id": "profile-xyz-789"
}

Redirects you to /app/calendar (or shows success toast)

Verify in Calendar View

Go to /app/calendar to see all scheduled posts in a calendar grid.Post card displays:

Thumbnail of media
Platform badge (color-coded)
Scheduled time
Caption preview (first 100 chars)
Status badge (Queued / Publishing / Published / Failed)

Queue Management

Viewing Your Queue

All scheduled posts are visible in:

Calendar View (/app/calendar) — visual timeline
Dashboard Stats — “Scheduled” count in the stat card
Directus Admin (/admin → scheduled_posts collection)

Editing a Scheduled Post

Find the Post

In /app/calendar, locate the post card.

Click 'Edit'

Click the gear icon in the top-right of the post card.

Update Fields

Modify:

Caption
Scheduled time
Media attachments
Tags/hashtags

You cannot change the platform after creation (delete and recreate instead).

Save Changes

Click Update Post. Changes are saved immediately.If the post was already picked up by the scheduler (status = publishing), edits won’t apply.

Canceling a Scheduled Post

Open Post Card

In /app/calendar, find the post.

Click 'Cancel'

Click the X icon or Cancel button.

Confirm Deletion

A confirmation modal appears: “Cancel this scheduled post? This cannot be undone.”Click Confirm.

Post Removed

The scheduled_posts record is:

Marked as status: 'cancelled' (not deleted)
Hidden from the calendar view
Skipped by the scheduler worker

Platform-Specific Publishing

Each platform has unique posting requirements. Genie uses Stagehand browser automation to handle them.

OnlyFans

Supported:

Image posts (single or gallery)
Video posts (up to 5GB)
Caption text (max 5000 chars)
Price (free or PPV)
Post visibility (all subscribers / VIP only)

Flow:

Stagehand logs in (using cookies or credentials)
Navigates to Post page
Uploads media via file input
Fills caption textarea
Sets price dropdown (if PPV)
Clicks Publish
Waits for success confirmation

Estimated time: 30-60 seconds per post

Fansly

Supported:

Image/video posts
Captions (max 3000 chars)
Tier restrictions (All / Tier 1 / Tier 2 / Tier 3)
Scheduled posts (via Fansly’s native scheduler)

Flow: Similar to OnlyFans, but uses Fansly’s tier dropdown.

Instagram

Supported:

Feed posts (1:1 or 4:5 aspect ratio)
Reels (9:16 vertical video)
Captions (max 2200 chars)
Hashtags (up to 30)

Limitations:

No direct API — uses Stagehand to automate the web uploader
May trigger bot detection — use sparingly
Alt text not supported (yet)

Flow:

Navigate to instagram.com
Click + Create
Upload media
Add caption and hashtags
Click Share

TikTok

Supported:

Video posts (9:16, 15s–10min)
Captions (max 150 chars)
Hashtags

Limitations:

No automation support yet — requires manual upload
Stagehand integration planned for Phase 10

X (Twitter)

Supported:

Text posts (max 280 chars, or 25,000 for X Premium)
Image posts (up to 4 images)
Video posts (max 2:20 for free, 60 min for Premium)

Flow:

Navigate to x.com
Click Post button
Fill text box
Upload media
Click Post

Queue Size Limits

The number of posts you can have queued at once depends on your plan:

Plan	Max Queued Posts
Starter	3
Creator	Unlimited
Pro	Unlimited
Studio	Unlimited

Starter users: You can only have 3 posts in the queue at a time. Once a post publishes, you can schedule another. This is designed to encourage upgrading to Creator ($49/mo).

Monitoring Published Posts

Real-Time Status Updates

When the scheduler picks up a post:

Status changes to publishing (blue “Processing” badge)
Job created in media_jobs with operation: 'publish_post'
Stagehand browser session starts
Platform login + upload + submit
Status updates to published (green “Published” badge) or failed (red “Failed” badge)

Success Confirmation

On success, the scheduled_posts record stores:

{
  "status": "published",
  "published_at": "2026-03-10T18:01:23.000Z",
  "platform_post_url": "https://onlyfans.com/123456789/post-abc",
  "platform_post_id": "123456789"
}

You can click the View on Platform button in the calendar to open the live post.

Failure Handling

If publishing fails:

Status changes to failed
Error message stored in error_message field
Post card shows Retry button
Click Retry to re-queue the post

Common errors:

“Login failed: Invalid cookies” → Recapture cookies via HITL guide
“Media upload failed: File too large” → Compress the file first
“Platform error: Duplicate content detected” → Platform rejected the post (edit and retry)

Advanced: Bulk Scheduling

Schedule multiple posts at once using the AI chat widget.

Example: Schedule a Week of Content

Schedule these 7 OnlyFans posts:
- Monday 6 PM: "Gym selfie 💪" (media ID: abc-123)
- Tuesday 6 PM: "New lingerie set 😘" (media ID: def-456)
- Wednesday 6 PM: "Behind the scenes 🎬" (media ID: ghi-789)
- Thursday 6 PM: "Throwback Thursday 🔥" (media ID: jkl-012)
- Friday 6 PM: "Friday vibes 🥂" (media ID: mno-345)
- Saturday 6 PM: "Weekend plans? 😏" (media ID: pqr-678)
- Sunday 6 PM: "Self-care Sunday 🛁" (media ID: stu-901)

Genie will:

Parse the list
Create 7 scheduled_posts records
Calculate UTC timestamps for each “6 PM” in your timezone
Return a summary with post IDs

Troubleshooting

Post stuck in 'publishing' for 10+ minutes

Cause: Stagehand browser session hung or worker crashed.Fix:

SSH to server: pm2 logs media-worker
Look for errors mentioning the job ID
Restart worker: pm2 restart media-worker
Go to /app/calendar and click Retry on the post

Post published but status still shows 'queued'

Cause: Worker failed to update Directus after publishing.Fix:

Check media_jobs in /admin for the job’s actual status
Manually update scheduled_posts record: set status: 'published'
Report the bug to support

Post failed: 'Platform login required'

Can't schedule more posts (queue full)

Cause: You’ve hit your plan’s queue limit (3 for Starter, unlimited for paid plans).Fix:

Wait for existing posts to publish (they auto-remove from queue)
Or cancel some queued posts to free up slots
Or upgrade to Creator tier for unlimited queue

Next Steps

AI Captions

Generate engaging captions for scheduled posts

Media Workflows

Watermark and compress before scheduling

HITL Sessions

Keep platform cookies fresh for reliable publishing

Usage

Administration

Development

Scheduling & Publishing Posts

How the Scheduler Works

Architecture

Worker Responsibilities

Scheduling Your First Post

Queue Management

Viewing Your Queue

Editing a Scheduled Post

Canceling a Scheduled Post

Platform-Specific Publishing

OnlyFans

Fansly

Instagram

TikTok

X (Twitter)

Queue Size Limits

Monitoring Published Posts

Real-Time Status Updates

Success Confirmation

Failure Handling

Advanced: Bulk Scheduling

Example: Schedule a Week of Content

Troubleshooting

Next Steps

AI Captions

Media Workflows

HITL Sessions

Build docs developers (and LLMs) love

Usage

Administration

Development

​How the Scheduler Works

​Architecture

​Worker Responsibilities

​Scheduling Your First Post

​Queue Management

​Viewing Your Queue

​Editing a Scheduled Post

​Canceling a Scheduled Post

​Platform-Specific Publishing

​OnlyFans

​Fansly

​Instagram

​TikTok

​X (Twitter)

​Queue Size Limits

​Monitoring Published Posts

​Real-Time Status Updates

​Success Confirmation

​Failure Handling

​Advanced: Bulk Scheduling

​Example: Schedule a Week of Content

​Troubleshooting

​Next Steps

AI Captions

Media Workflows

HITL Sessions

Build docs developers (and LLMs) love

How the Scheduler Works

Architecture

Worker Responsibilities

Scheduling Your First Post

Queue Management

Viewing Your Queue

Editing a Scheduled Post

Canceling a Scheduled Post

Platform-Specific Publishing

OnlyFans

Fansly

Instagram

TikTok

X (Twitter)

Queue Size Limits

Monitoring Published Posts

Real-Time Status Updates

Success Confirmation

Failure Handling

Advanced: Bulk Scheduling

Example: Schedule a Week of Content

Troubleshooting

Next Steps