npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

n8n-nodes-viral-loops

v0.1.0

Published

n8n community node for the Viral Loops referral-campaign API (v3). Full endpoint coverage: participant registration with referrer attribution, participant data/rank/order/referrals/referrer, batch query, search, flag, conversions, rewards (pending/given/r

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

thecamarsenaultthecamarsenault

Keywords

n8n-community-node-packagen8nviral-loopsreferralwaitlistepic-dashboards

Readme

n8n-nodes-viral-loops

Open in Obsidian: obsidian://open?vault=Epic%20Tech%20Software&file=projects/epic-dashboards/n8n-nodes-viral-loops/README

n8n community node for the Viral Loops referral-campaign API (v3). Built by Epic Tech Software for the Epic Dashboards founding funnel; general-purpose. Ships prebuilt dist/ (same pattern as n8n-nodes-epic-ghl-subaccount) — no build step.

Spec source: official OpenAPI 3.1 definitions at developers.viral-loops.com/reference (fetched 2026-07-19).

Operations (full v3 coverage)

| Resource | Operations | |---|---| | Participant | register (with referrer attribution + optional ready-to-share referralLink composition) · update · get data · get referrals · get referrer · get order · get rank · convert · query (batch) · search · flag | | Reward | get pending · get given · redeem (irreversible) | | Campaign | get stats · get data |

API facts baked in

  • Base https://app.viral-loops.com/api/v3; auth = header literally named apiToken (campaign secret, no Bearer). Tokens are per-campaign (Campaign Wizard → Installation step) — one credential per campaign.
  • Registration returns {referralCode, isNew} only — no URL. The share link is <campaign landingPage>?referralCode=<code>; the node's Resolve Referral Link toggle (register/get) fetches /campaign/data and outputs referralLink composed for you.
  • Attribution = referrer.referralCode on registration. The web snippet also parses referralCode/refCode/ref URL params.
  • Rate limits/min: registration 80 · convert 25 · everything else 300.
  • Convert is template-restricted (Milestone, Altruistic, Online-to-Offline, Universal) — it does NOT work on waitlist (Startup Prelaunch) campaigns.
  • Outbound webhooks (configure per campaign → Integrations → Webhooks): participation, milestoneReached, rewardRedeemed. Unsigned — verify by calling the API back. Retries with exponential backoff up to 4 days; failing endpoints get auto-disabled. No conversion webhook (Zapier-only trigger).
  • Error envelope: {statusCode, error, message}.
  • Unverified corners (probe before relying): user.consents shape, refSource/acquiredFrom allowed values, referrals/referrer/rewards item shapes, participant-update required-fields contradiction.

Install on the Elestio n8n

Settings → Community Nodes → Install from npm (after publishing), or copy this folder into the instance's community-nodes dir. Publishing to npm: npm publish from this folder (Cameron's npm account; version bump per RELEASING.md conventions in the GHL node package).

Credential: Viral Loops API — paste the campaign's secret apiToken (+ optionally the publicToken/campaign id).

Note on the live founding-funnel workflows

The three ED — * funnel workflows (Founding List Intake + Viral Loops · VL Participant Lookup · VL Participation Webhook) intentionally use plain HTTP Request nodes with a generic Header-Auth credential named "Viral Loops apiToken", so they run without this package installed. This node is the reusable/typed path for everything after (rewards, flagging, search, future campaigns). Swap-in is 1:1.