n8n-nodes-preroll
v0.2.8
Published
n8n community node for PreRoll.io — podcast production management platform
Readme
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:
- Log in to your PreRoll instance
- Go to Settings → API Keys
- Click Create API Key and copy the key (starts with
pr_) - 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 updatedepisode.stage_changed— Episode moved to a different pipeline stageepisode.published— Episode publishedepisode.scheduled— Episode scheduled for publishingdeliverable.submitted— New deliverable submitted for reviewdeliverable.approved— Deliverable approved by clientdeliverable.revision_requested— Client requested revisions on a deliverabledeliverable.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-prerollLicense
MIT
