Getting Started

Introduction

What the Content Engine is, what it does, and key concepts you need to know.

The Content Engine is Vlozi's social media scheduling service. Connect your Twitter/X, LinkedIn, Facebook, and Instagram accounts, plan content in a calendar, and let Vlozi publish it automatically at the right time.

What you get

  • Multi-platform calendar — one place to see and manage posts across all your accounts
  • Reliable publishing — Cloudflare queue-backed delivery with automatic retry and dead-letter handling
  • Approval workflow — optional review step before content goes live
  • Recurring schedules — cron-based patterns that generate draft or scheduled slots automatically
  • Analytics — post engagement metrics, audience growth, and smart insights (viral detection, underperformance alerts, best-time-to-post heatmap)
  • Agent control — schedule and manage content via MCP tools from any AI agent

Key concepts

Content slot

A content slot is a single piece of content scheduled for a specific time. It holds:

  • Caption — the text body of the post
  • Media — up to 4 images (video not yet supported)
  • Scheduled time — exact UTC time the post should go live
  • Targets — which social accounts will receive this post (one slot can publish to multiple accounts simultaneously)
  • Content typetext, image, video (future), carousel (future), story (future), link

Slot target

Each slot target is the combination of one content slot and one social connection. When a slot publishes to three platforms, it creates three targets — each tracked and retried independently.

Campaigns

A campaign is a named group you can assign slots to for organizational purposes. Useful for thematic planning ("Launch Week", "Q3 Product Updates"). Campaigns have optional start/end dates and a color for visual grouping in the calendar.

Labels

Labels are free-form tags you assign to slots (e.g., "evergreen", "promo", "blog"). Many-to-many — one slot can have multiple labels, one label can appear on many slots.

Recurring schedule

A recurring schedule is a cron pattern that automatically generates new content slots on a regular cadence. You set a caption template, target accounts, and a cron expression. The engine generates slots in advance and either puts them in draft (for you to review) or schedules them directly.

Social connection

A social connection is an authorized OAuth link between your Vlozi account and a social media platform account. Tokens are encrypted with AES-256-GCM and never exposed in API responses.

Supported platforms

Platform Publishing Media Metrics Token lifetime
Twitter / X Images (up to 4) ✅ Full (impressions, clicks, profile visits) ~2 hours (auto-refreshed)
LinkedIn Images ⚠️ Limited (platform API restriction) ~60 days (manual reconnect)
Facebook Images ⚠️ Limited ~60 days (manual reconnect)
Instagram Images ⚠️ Limited ~60 days (manual reconnect)

NOTE

Video publishing is not yet supported on any platform. Content slots with content_type: "video" will fail at publish time.

Credits

Publishing costs 1 credit per platform per post. Scheduling a post to three platforms costs 3 credits, charged at the moment each target is successfully published (not when scheduled).

Analytics polling costs 1 credit per connected account per day, billed in daily increments regardless of how many posts are polled.

Credits are shared across all Vlozi services.

Content Engine · Getting StartedEdit on GitHub