Schedules

Schedules is the brain of Missinglettr. It orchestrates all concepts—Workspaces, Social Accounts, Post Windows, and Campaigns—to generate optimal posting schedules months in advance.

How Schedules Orchestrates Everything

Schedules brings together all the pieces to create your perfect posting strategy:

What Schedules Does

Schedules analyzes all your configuration and generates an optimal posting calendar:

• Reads your Post Windows to know when posting is allowed
• Checks blackout days and vacation periods to avoid bad timing
• Reviews Campaign settings to know which posts go to which channels
• Respects campaign start and end dates
• Optimizes posting times per channel based on engagement data
• Schedules content months in advance so you can set and forget

Scheduling Modes

Schedules offers three ways to schedule content:

{
  "content": "Join us live at 2 PM!",
  "schedule_time": "2024-01-15T14:00:00Z"
}

POST /v1/workspaces/{id}/schedule/queue/
{
  "post_id": 123,
  "campaign_id": 456
}

# Process the queue to generate schedule
POST /v1/workspaces/{id}/schedule/queue/process/

Scheduling Months of Content

Schedules is designed to handle large volumes of content far into the future:

The Post Queue

The post queue is your staging area for content waiting to be scheduled:

1. Create posts and add them to the queue (or bulk import from CSV)
2. Assign posts to campaigns (determines channel targeting)
3. Reorder posts to set priority
4. Click "Process Queue" when ready
5. Schedules analyzes all concepts and generates optimal schedule

Intelligent Processing

When you process the queue, Schedules does sophisticated analysis:

Queue Management

Manage your queue in the console:

• View Queue - See all posts waiting to be scheduled
• Reorder - Drag and drop to change priority
• Edit - Modify post content before scheduling
• Bulk Import - Upload CSV with months of content
• Process - Generate optimal schedule for all queued posts

# Add posts to queue
POST /v1/workspaces/{id}/schedule/queue/
{
  "post_id": 123,
  "campaign_id": 456
}

# Process queue to generate schedule
POST /v1/workspaces/{id}/schedule/queue/process/

Real-World Example

Here's how all the concepts work together in a typical workflow:

Post Status

Track where posts are in the scheduling lifecycle:

Bulk Scheduling Workflows

Schedules is built for scale. Common bulk workflows:

• CSV Import - Upload spreadsheet with 100+ posts, assign to campaigns, process queue
• API Batch - Send months of content via API in minutes
• Integrations - Auto-add posts from Notion, Airtable, Google Sheets via Zapier/Make
• Content Calendar Sync - Import your entire quarterly content plan at once

Scheduling Rules

How Schedules makes decisions:

• Only schedules within defined Post Windows
• Never schedules on blackout days or during vacation periods
• Respects campaign start/end dates (won't schedule outside range)
• Only posts campaign content to its designated channels
• Never double-books a post window
• Optimizes time within each window based on channel best practices

Best Practices

• Plan Quarterly: Schedule 3 months of content at once, not week-by-week
• Set Blackouts Early: Add all holidays for the year upfront
• Use Campaign Targeting: Let campaigns determine channel distribution automatically
• Review Before Processing: Check queue order and campaign assignments
• Monitor Fill Rate: Ensure you have enough post windows for your content volume
• Adjust Windows as Needed: Add more slots if you're creating more content

API Usage

Automate the entire scheduling flow via API:

# 1. Bulk create posts
POST /v1/workspaces/{id}/posts/bulk/
{
  "posts": [
    {"content": "...", "campaign_id": 123},
    {"content": "...", "campaign_id": 123},
    // ... 100+ posts
  ]
}

# 2. Add all to queue
POST /v1/workspaces/{id}/schedule/queue/bulk/
{
  "post_ids": [1, 2, 3, 4, 5, ..., 100]
}

# 3. Process queue - schedules all posts optimally
POST /v1/workspaces/{id}/schedule/queue/process/

# Result: Months of content scheduled in seconds