preroll.io docs
Developer

n8n Node

Automate podcast production workflows with the verified preroll.io node for n8n.

Open with AI:ClaudeChatGPT

Overview

The n8n-nodes-preroll node lets you interact with preroll.io directly from n8n workflows. Use it to automate episode creation, monitor pipeline progress, trigger actions when deliverables are approved, and more.

This node is verified by the n8n team and appears with a shield icon in the n8n nodes panel.

The package includes two nodes:

  • PreRoll.io — perform actions (create episodes, update clients, run AI pipelines, etc.)
  • PreRoll.io Trigger — start workflows when events occur (episode published, deliverable approved, etc.)

Installation

Search for PreRoll.io in the n8n nodes panel to install it directly. Verified nodes can be installed without changing any n8n settings.

You can also install manually via Settings → Community Nodes:

n8n-nodes-preroll

Or via CLI:

cd ~/.n8n
npm install n8n-nodes-preroll

Restart n8n after manual installation.

Credential Setup

  1. In preroll.io, go to Settings → Developer → API Keys and create a new key
  2. In n8n, go to Credentials → Add Credential → PreRoll.io API
  3. Paste your API key (starts with pr_)
  4. The Base URL defaults to https://preroll.io — change this only for self-hosted instances

PreRoll.io Node

The main node supports the following resources and operations:

ResourceOperations
ClientGet, Get Many, Create, Update
ShowGet, Get Many, Create, Update
EpisodeGet, Get Many, Create, Update
DeliverableGet Many, Create, Update
Pipeline StageGet Many (per show)
TagGet Many, Create
Meeting NoteGet Many, Create
ActivityGet Many
AIGet Credits, Transcribe Episode, Generate Content, Run Pipeline
DashboardGet Overview

PreRoll.io Trigger Node

The trigger node registers a webhook with preroll.io and starts your workflow when selected events occur:

EventFires when
episode.status_changedEpisode status changes (draft, in_progress, published)
episode.stage_changedEpisode moves to a different pipeline stage
episode.publishedEpisode published to distribution
episode.scheduledEpisode scheduled for future publication
deliverable.submittedDeliverable submitted for client review
deliverable.approvedClient approves a deliverable
deliverable.revision_requestedClient requests revisions
deliverable.resubmittedRevised deliverable resubmitted

The trigger automatically registers and deregisters its webhook endpoint when you activate or deactivate the workflow. Webhook payloads are signed with HMAC-SHA256 and verified automatically by the node.

Example Workflows

Notify Slack when an episode is approved

  1. PreRoll.io Trigger → events: deliverable.approved
  2. Slack → send message to #production with episode title and client name

Auto-transcribe new episodes

  1. PreRoll.io Trigger → events: episode.stage_changed
  2. IF → stage equals "Editing"
  3. PreRoll.io → AI: Transcribe Episode

Weekly production report

  1. Schedule Trigger → every Monday at 9 AM
  2. PreRoll.io → Dashboard: Get Overview
  3. Email → send summary to team

Self-Hosted Instances

If you're running a self-hosted preroll.io instance, update the Base URL in your credential to point to your instance (e.g., https://preroll.yourdomain.com). The node appends /api/v1/... to whatever base URL you provide.

On this page