What it does

POST every peepshow run to a Zapier Catch Hook URL (`https://hooks.zapier.com/hooks/catch/<user>/<hook>/`). Unlike the generic webhook sink, Zapier's Zap editor flattens top-level JSON keys into per-step variables — so this sink emits `video_codec`, `audio_duration_seconds`, `transcript_text`, etc. at the top level, and hoists every `video.tags[key]` to `tag_<key>`. Adds an optional HMAC-SHA256 `X-Zapier-Signature` header (verified in a Code-by-Zapier step), plus run-metadata headers (`X-Peepshow-Run-Id`, `X-Peepshow-Duration-Seconds`). Retries on 429 (hook quota) and 5xx with exponential backoff up to 3 times.

When to reach for it

Non-developer Zap builders who need top-level variables in the Zap picker
Fan out a peepshow run to Slack / Trello / Google Sheets / Gmail without writing a Code step
Prototype multi-step automation before baking it into a dedicated sink

Install

npm i -g peepshow

Use it

export ZAPIER_HOOK_URL="https://hooks.zapier.com/hooks/catch/1234567/abcdef/"
peepshow sinks add zapier
peepshow ./video.mp4

Make it automatic

peepshow sinks add zapier
peepshow sinks add zapier --when extension=mp4,mov
peepshow sinks add zapier --when path=/Volumes/Work/

Configuration

ZAPIER_HOOK_URL Catch Hook URL, e.g. `https://hooks.zapier.com/hooks/catch/<user>/<hook>/`. required
ZAPIER_SIGNING_SECRET Optional HMAC-SHA256 signing key. When set, each POST includes an `X-Zapier-Signature` header. Zapier itself doesn't validate this — a Code step does.
ZAPIER_RETRY_MAX Max retries on 429/5xx. Default `3`.
ZAPIER_TIMEOUT_MS Per-request timeout in milliseconds. Default `15000`.

Use with an LLM agent

Every peepshow sink reads its config from env vars and receives a single JSON payload on stdin. An LLM agent (Claude Code, Cursor, Windsurf, Gemini, Codex) can drive the Zapier sink automatically when three things are true:

the env vars below are exported in the agent's shell (or a project .env it can load),
the peepshow CLI is on PATH — install with npm i -g peepshow,
a peepshow auto-sink is registered for the run (optional but recommended — makes invocation zero-argument).

1. Set the environment

# Add to ~/.zshrc, ~/.bashrc, or a project .env the agent can load
export ZAPIER_HOOK_URL="..."

2. Register as an auto-sink

peepshow sinks add zapier
peepshow sinks add zapier --when extension=mp4,mov

3. Example LLM session

You → drop a .mov into Claude Code.
Claude → auto-invokes /peepshow:slides ./clip.mov. peepshow extracts frames + audio, the Zapier sink forwards the run to the configured Zapier target. Claude replies with a summary and a link to the created record.

The transcript rides along in the payload whenever the audio pass transcribes successfully.

Write your own

A sink is any executable that reads the --emit json payload on stdin. Shell, Node, Python, Go — the spec's in docs/PLUGINS.md. Register persistent ones with peepshow sinks add-cmd 'your-command'.

Zapier — POST runs to a Zapier Catch Hook with a flat event shape.