Description

n8n-nodes-puppetflow

This is an n8n community node. It lets you use the Puppetflow browser automation API in your n8n workflows.

Puppetflow is a browser automation platform that lets you trigger flows, monitor runs, and retrieve artifacts (screenshots, downloads, recordings).

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

> Flow

• Trigger a flow (with optional JSON input)

> Run

• List runs (paginated, with status filter)
• Get a run
• Get run result (output, timing, status)

> Artifact

• List artifacts (screenshots or downloads)
• Download a specific artifact file
• Download session recording (video/mp4)

Credentials

To use this node, you need:

1. A Puppetflow account at puppetflow.com
2. Your instance URL (e.g. https://your-team.puppetflow.com)
3. An API key generated from your profile page

Compatibility

This node is compatible with n8n version 1.0.0 and above.

Usage

1. Trigger a flow: Start a browser automation flow by its ID. Optionally pass JSON input data.
2. Monitor runs: List all runs for a flow (filter by status), get details of a specific run, or fetch the output of a completed run.
3. Download artifacts: Retrieve screenshots, downloaded files, or session recordings from completed runs.

Development

npm install
npm link
npm run dev

In a separate terminal, link the package into your n8n custom nodes directory:

cd ~/.n8n
mkdir -p custom && cd custom
npm init -y
npm link n8n-nodes-puppetflow
n8n start

Resources

• n8n community nodes documentation
• Puppetflow website