How a run goes
- 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. - A new piece every run. At
post_hour:post_minuteintime_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 whenallowed_templatesleaves room, toward yourdirection. Once its words are written, they are checked against your recent videos and posts, and a repeat is rewritten before anything is rendered. - Posting. Each piece is made with no review and posted to every account in
connection_ids.
"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 planPOST /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 fromGET /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
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}.