Skip to content

tro2789/n8n-nodes-preroll

Repository files navigation

n8n-nodes-preroll

n8n community node for PreRoll — podcast production management.

Interact with your PreRoll instance from n8n workflows: manage clients, shows, episodes, deliverables, tags, and AI features. Includes a trigger node for real-time webhook events.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm package name: n8n-nodes-preroll

Credentials

You need a PreRoll API key to authenticate:

  1. Log in to your PreRoll instance
  2. Go to Settings → API Keys
  3. Click Create API Key and copy the key (starts with pr_)
  4. In n8n, create a new PreRoll API credential with your API key and base URL

API keys require a Pro or Studio plan.

Nodes

PreRoll

The main node supports these resources and operations:

Resource Operations
Client Get, Get Many, Create, Update, Delete
Show Get, Get Many, Create, Update, Delete
Episode Get, Get Many, Create, Update, Delete
Deliverable Get, Get Many, Create, Update
Tag Get Many, Create, Update, Delete
Meeting Note Get Many, Create
Pipeline Stage Get Many
Activity Get Many
AI Get Credits, Get Transcription, Transcribe Episode, Generate Content, Run Pipeline
Dashboard Get Overview

PreRoll Trigger

Webhook-based trigger that starts workflows when events occur in PreRoll:

  • episode.status_changed — Episode status updated
  • episode.stage_changed — Episode moved to a different pipeline stage
  • episode.published — Episode published
  • episode.scheduled — Episode scheduled for publishing
  • deliverable.submitted — New deliverable submitted for review
  • deliverable.approved — Deliverable approved by client
  • deliverable.revision_requested — Client requested revisions on a deliverable
  • deliverable.resubmitted — Deliverable resubmitted after revision

The trigger node automatically registers and deregisters webhook endpoints in PreRoll when the workflow is activated/deactivated.

Example Workflows

Import-ready workflow templates are in the examples/ directory:

Workflow Description File
Slack Notifications Get real-time Slack messages for episode and deliverable events slack-notifications.json
Todoist Episode Tasks Auto-create a Todoist task when a new episode is created todoist-episode-tasks.json

To import: in n8n, go to Workflows → Import from File and select the JSON file.

See examples/README.md for setup instructions and a full webhook payload reference.

More ideas

  • Auto-transcribe new episodes — PreRoll Trigger (episode.stage_changed) → IF (stage = "Editing") → PreRoll AI Transcribe
  • Weekly episode report — Schedule Trigger (every Monday) → PreRoll Dashboard → Email
  • Stripe → client onboarding — Stripe Trigger (checkout completed) → PreRoll Create Client → Create Show

Development

# Install dependencies
npm install

# Build
npm run build

# Link for local testing
npm link
cd ~/.n8n/custom
npm link n8n-nodes-preroll

License

MIT

About

n8n community node for PreRoll.io — podcast production management

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages