Workflows

Automations#

Automations trigger recurring AI-generation workflows without manual intervention. Each run creates brand-consistent content, stores generated assets in the Library, and routes posts through your approval policy before publishing.

Two Ways to Create an Automation#

Manual (form)

From Automations → New automation, pick every parameter yourself: platforms, frequency, day, publishing time, and approval mode. Best when you want precise, deliberate control over the schedule.

Via VIBE or Turbo (AI)

Describe it in natural language on the web chat or in Telegram: "create a weekly automation every Monday for Instagram and Facebook, auto-publish". VIBE resolves your connected platforms, checks your editorial charter, and creates it without opening the Automations page.

Both paths share the exact same scheduling, credit, and styling logic: only the interface changes. An automation created via chat can still be edited from the form afterward, and vice versa.

Creating an automation (form vs VIBE)

YouTube
Photo, Video or Hybrid#

Every automation has a content type. Photo generates brand visuals, Video generates short-form clips (Gemini Omni Flash, Kling, Seedance), and Hybrid mixes both across the week so a single automation covers your whole content calendar.

Photo

Brand-consistent still visuals for every run. Works on all networks.

Video

Short-form video clips with your chosen model, duration and aspect ratio. Required for YouTube.

Hybrid

Photos and videos, planned across the week. Each day picks the right format for its platform.

The weekly work plan (Hybrid)

When a Hybrid automation runs, it first builds a weekly work plan: a day-by-day schedule stating, for each slot, whether to publish a photo, a video or both, on which platforms, plus the exact video script (scenes and duration). The plan is the single source of truth (content is generated strictly from it, which keeps the output on-brief and prevents drift). Each item is marked Done, Pending, Failed or Skipped as the week progresses, and the whole plan is surfaced in Automation Tracking.

Credits are escrowed per plan: the whole week's cost is reserved upfront from the project owner's balance, then the difference is refunded after generation so you're only ever charged for what was actually produced : never more than reserved.

AI advice when you set the objective

As soon as you describe the automation's objective, an AI advisory layer suggests the best content type (photo, video or hybrid), format and the platforms to target (bounded by the accounts you have actually connected). You stay in control: the suggestion is a starting point you can accept or override.

Automation Execution Pipeline#
workflow
Roughly one hour before the configured publishing time (daily / weekly / biweekly / monthly / custom):
─────────────────────────────────────────────────────────────
1. A cron job checks every 15 minutes → POST /api/cron/run-automations
2. Eligible automations resolved (enabled, preparation window open, within plan limits)
3. For each automation:
   a. Brand context is applied (charter, palette, fonts, tone)
   b. Credits are metered for the run; active automation slots only limit workflow count
   c. Content is generated with a consistent visual structure
   d. Generated assets are stored in the Library
   e. Publishable posts are sent to the Posts / publication queue for the target time
4. Approval routing:
   → manual    → post waits for approval
   → scheduled → post waits, then auto-approves after the delay
   → auto      → post is scheduled for publishing when its visual is ready
5. Publishing:
   → Approved posts pushed to social APIs at posting_time
   → Failed posts retry with backoff, then log error detail
Automation Parameters#
namestring

Automation name displayed in the dashboard and notification center.

frequency"daily" | "weekly" | "biweekly" | "monthly" | "custom"

Trigger frequency. Daily ignores day_of_week.

day_of_week0–6 (0=Sunday)

Trigger day (for weekly frequency).

time_of_dayHH:MM (24h)

Target publishing time. Internal generation starts about one hour before this time.

enabledboolean

Enable or suspend an automation without deleting it.

approval_mode"manual" | "scheduled" | "auto"

Approval policy: manual review, delayed auto-approval, or automatic publishing when the generated visual is ready. The legacy auto_approve boolean stays in sync with this field for older automations.

credit_metering3 or 5 credits / visual

Each generated visual consumes credits at execution time: Standard costs 0.5 credits and Premium costs 1 credits. If credits are exhausted, the automation is paused before generation.

visual_consistencybrand template

Automation visuals reuse the same brand palette, typography and layout structure so recurring posts remain visually consistent over time.

platformsstring[]

Target networks: ['instagram', 'facebook', 'linkedin', 'tiktok', 'youtube'].

Documentation Feedback#

Was this documentation helpful?