PreRoll.io icon

PreRoll.io

Interact with PreRoll.io — podcast production management

Episode → Create

AI-generated

Summary

Creates a new episode under a given PreRoll.io show by POSTing the title and any optional fields to the show's episodes endpoint. Returns the created episode record.

Inputs

  • Show ID (required) — UUID of the show the episode is created under. It is used in the request path (/shows/{showId}/episodes).
  • Title (required) — Episode title, sent as title in the request body.
  • Additional Fields — Optional collection merged into the request body as-is: Description, Episode Number (number), Notes, Scheduled Publish Date (YYYY-MM-DD string), and Stage ID (pipeline stage UUID). Only the fields you add are sent.

Output shape

One item per input item, containing the created episode as returned by the PreRoll.io API. The node unwraps the response's data property if present, otherwise it returns the whole response.

The exact fields of the episode are defined by the PreRoll API and are not declared in the node. With Continue On Fail enabled, a failed item yields an item with an error message instead of stopping the workflow. The request runs once per input item, authenticated with the PreRoll API credential.

Examples

Example 1: Create a new episode in a show's pipeline when a recording is booked

Resource: Episode, Operation: Create, Show ID: show UUID, Title: 'Ep 42 – Interview with Jane', Additional Fields: Episode Number 42, Scheduled Publish Date 2026-11-05.

Example 2: Create an episode directly in a specific pipeline stage with notes

Show ID and Title set; Additional Fields: Stage ID = stage UUID (from Pipeline Stage > Get Many), Notes = 'Guest requires pre-approval'.

Links

Discussion