How To Build An N8N Workflow For Automated Video Generation

Why Scrptly + N8N is perfect for video automation

• End-to-end AI video agent: Describe the video you want, optionally attach context images, and Scrptly handles scripting, character design, scene generation, narration, and editing—automatically.
• Long-form and consistency: Scrptly shines at longer videos and maintains character and environment consistency across scenes.
• Built for automation: Use the Scrptly N8N node in any workflow to generate videos programmatically. It also offers an API, MCP server, and a Video Development Kit for developers.
• Flexible distribution: Chain your Scrptly output to YouTube, TikTok, S3, Drive, or social schedulers with standard N8N nodes.

What you’ll build

1. Accepts a brief (via webhook, schedule, or a Google Sheet row)
2. Generates a complete video with Scrptly’s AI Video Agent
3. Stores the final file (e.g., S3/Drive) and optionally posts to social
4. Notifies your team with links and metadata

Prerequisites

• An N8N instance (self-hosted or cloud)
• A Scrptly account and API key: https://scrptly.com/
• The Scrptly community node for N8N: https://github.com/ybouane/n8n-nodes-scrptly

Step 1: Install the Scrptly N8N node

• In N8N, go to Settings > Community Nodes > Install New
• Search for n8n-nodes-scrptly and click Install

• Open Credentials > New > Select "Scrptly API"
• Paste your Scrptly API key and save

Step 2: Choose your trigger

• Schedule Trigger: Batch-generate videos daily at 9 AM
• Webhook: Accept a JSON brief from your CMS, form, or Slack command
• Google Sheets Trigger: Create a video for each new content row

{

  "title": "5 Ways to Clean White Sneakers",

  "style": "UGC, friendly, handheld, natural light",

  "aspectRatio": "9:16",

  "duration": 45,

  "cta": "Shop our eco-friendly cleaner",

  "contextImageUrls": [

    "https://example.com/images/sneaker-1.jpg",

    "https://example.com/images/cleaner-bottle.jpg"

  ]

}

Step 3: Build your prompt dynamically

Create a {{$json["duration"]}}-second {{$json["style"]}} video titled "{{$json["title"]}}".

- Audience: sneaker enthusiasts on TikTok.

- Hook in first 3 seconds.

- Include voiceover with warm, friendly tone.

- Visual direction: close-ups of stains, natural textures, before/after reveal.

- CTA: {{$json["cta"]}}.

- Aspect ratio: {{$json["aspectRatio"]}}.

- Keep character and scene consistency across all shots.

Step 4: Configure the Scrptly node

• Prompt: the template above (using expressions)
• Context Images: array of URLs or binary file inputs from previous nodes
• Approve Up To: a maximum token budget (defaults to 10,000)
• Wait For Completion: ON for simple flows; OFF if you want async behavior and to poll by task ID later

• Interpret your prompt
• Research/script the story
• Design characters and environments
• Generate scenes and narration
• Edit the final video automatically

Step 5: Save and distribute the video

• File Storage: Add an S3, Google Drive, or Dropbox node to store the video output URL from Scrptly
• Social Upload: Use YouTube, Twitter, LinkedIn, or custom API nodes to publish
• Notifications: Send a Slack/Email summary with title, video link, and thumbnail

New video generated ✅

Title: {{$json["title"]}}

Link: {{$json["scrptlyVideoUrl"]}}

Storage: {{$json["storageUrl"]}}

CTA: {{$json["cta"]}}

Example workflow architecture

1. Trigger (Schedule or Webhook)
2. Transform/Validate (Set/Function) – ensure title, duration, aspectRatio
3. Scrptly Node – generate video from prompt + context images
4. Store File – upload to S3 or Drive using the returned video URL
5. Publish (optional) – YouTube/TikTok integration or a custom API
6. Notify – Slack/Email with links and metadata
7. Log – Append to a Google Sheet or Notion DB for tracking

Advanced tips for reliable, scalable video automation

• A/B Testing: Fork your flow into two Scrptly nodes with variations in hooks, voiceover tone, or CTA. Publish both and compare CTR or watch time.
• Async Generation: Turn off "Wait For Completion" to return a task ID immediately. Use a Wait/Poll loop to check status and proceed when done—handy for long-form videos.
• Context Consistency: Always pass the same product and character images for series content. Scrptly excels at keeping visuals consistent across scenes.
• Guardrails: Validate inputs (duration, aspect ratio) and fail gracefully. Route errors to a Slack channel and retry with exponential backoff.
• Metadata Enrichment: Add hashtags, SEO-friendly titles, and descriptions based on the original brief. You can generate these in N8N before posting.
• Multi-Channel Formatting: Branch the workflow to request multiple aspect ratios (16:9, 1:1, 9:16) by running Scrptly with different prompts.

Prompt recipes you can copy

• Ecommerce/UGC Ad

Create a 30-second vertical UGC-style ad for our eco-friendly leather conditioner.

Hook in 2 seconds: visible scratch on a leather bag, quick gasp.

Show natural light close-ups, ASMR-style application, quick before/after.

Warm voiceover, 105–115 WPM. End with soft CTA: "Restore it today." Keep product visuals consistent across cuts.

• Explainer/Docu-Style

Produce a 60-second 16:9 explainer about how whales communicate through songs.

Use clean infographics, oceanic color palette, gentle piano underscore.

Include narration with calm, authoritative tone. Maintain character and scene consistency.

• Anime/Short Film

Create a 90-second anime short about a fox learning to glide at dusk.

Soft orange/purple palette, pastoral fields, gentle wind SFX, minimal dialogue.

Consistent character design for the fox and recurring tree by the hill.

Developer extras (optional)

npm install scrptly

import Scrptly from 'scrptly';



Scrptly.setApiSettings({

  apiKey: process.env.SCRPTLY_API_KEY,

});

Troubleshooting

• Timeouts: For long, complex prompts, disable "Wait For Completion" and poll until the task is finished.
• Inconsistent characters: Reuse the same context images and explicitly mention consistency in your prompt.
• Low engagement: Test multiple hooks, pacing changes, and different CTAs with A/B branches.

Ready to automate your video pipeline?