Skip to main content
A video schedule is a standing order: “make 2 videos every Monday, Wednesday and Friday and post them to these accounts at 9am”, or the same for posts. It runs as a Lincoln AI scheduled task. It is the Schedules tab of Viral Content, and schedules made here show up there (and the other way round), and under Lincoln AI → Scheduled Tasks.

How a run goes

  1. Research, once. The first run researches the business: the website (video_settings.source_url, else your marketing profile’s), its competitors on Instagram and their best reels, recent headlines and what is trending. Every later run reuses that research instead of doing it again. Changing the schedule’s source starts it over.
  2. A new piece every run. At post_hour:post_minute in time_zone, Lincoln reads what was already made from the same sources and makes each piece unlike them: another product, service, audience or proof, another hook and tone, another template when allowed_templates leaves room, toward your direction. Once its words are written, they are checked against your recent videos and posts, and a repeat is rewritten before anything is rendered.
  3. Posting. Each piece is made with no review and posted to every account in connection_ids.
As each run starts, the API key’s user gets an email saying what it will make, with a link to manage the schedule. Send "notify_by_email": false to turn that off. Pausing the schedule or skipping the next run means nothing is made, charged or posted.

Pricing

Creating and changing schedules is free. Each video a schedule makes is charged as it is generated, like any other video made through the API: at the cost of the providers that make it plus 20%, from your included video credits first, then your prepaid balance. That is on the API & MCP plan and the Growth Marketing Manager hire; on Revenue Engine and Custom what a schedule makes is free, and on any other plan POST /v1/video-schedules returns 403 plan_not_included. estimated_price_cents_per_video on the schedule is about what each costs; when Lincoln picks the template per video (estimate_depends_on_template: true) the real price depends on its pick. Pin the template with allowed_templates (or model the schedule on a video with source_video_id) for a steadier price. Without allowed_templates, Lincoln never picks freeform_ai, which is billed per generated second. See Videos for how videos are priced.

Start a schedule

Get account ids from GET /v1/social-connections.
ai_videographer is the AI Videographer, which edits like a human editor: animation, real footage, photos, cutouts and a presenter on camera. Every piece gets its own caption written for it. video_settings pins parts of every video’s recipe (format, length, presenter, voice, style, source); Lincoln decides the rest. PATCH merges new video_settings over the pinned ones. For posts instead of videos, send "content_type": "post" and, optionally, the post_formats a run may pick from (text, image, carousel). Without them, every post is an image post: the words with one relevant photo found on the web. Every account must take every format: TikTok and Instagram need a picture, YouTube takes videos only.

Pause, skip, stop

If a run does not go out, last_error says why and the schedule keeps running. What it made are ordinary videos and posts: list them with GET /v1/video-schedules/{id}/videos and read one with GET /v1/videos/{id}.