n8n-nodes-pewpros

This is an n8n community node. It lets you use the Pewpros
CRM, events, and learning platform in your n8n workflows.

Pewpros is a multi-tenant platform for contacts, tags, lists, events, courses,
certifications, conversations, waivers, and affiliate leads. This package
provides an action node for the REST API, a trigger node that starts
workflows from Pewpros outbound webhooks, and a poll trigger node for
record types without webhook topics (waiver signatures, affiliate leads).

n8n is a fair-code licensed
workflow automation platform.

Installation
Credentials
Operations
Trigger
Poll Trigger
Compatibility
Resources

Installation

Follow the
installation guide
in the n8n community nodes documentation.

In your n8n instance, go to Settings > Community Nodes, select Install,
and enter n8n-nodes-pewpros.

Credentials

This package ships two credential types. The Base URL must be https://
(plain http:// is rejected so your key is never sent in cleartext; localhost
is the one exception, for local development).

Pewpros API (Bearer)

Used by the Pewpros action node and the Pewpros Trigger node. Most write
operations require the user to have an admin role (owner, instructor,
staff, or super_admin).

• API Token — the user's Bearer API token.
• Base URL — your Pewpros instance, no trailing slash.
  • Production example: https://app.pewpros.com
  • Development example: https://dev.pewpros.com
  • Tenants on custom domains use their own domain.

Verified against GET /api/v1/auth/me.

Pewpros Partner API (X-Partner-Key)

A secret server-to-server key (sk_partner_...) for the facility-management
partner API under /api/v1/partner (customers, memberships, range, bookings,
orders, events). Generate and rotate it in Site Settings → Integrations;
it is not the public funnel key (pk_...). There is no dedicated partner
action node yet — pair this credential with n8n's built-in HTTP Request node
to call partner endpoints.

• Partner Key — the sk_partner_... secret.
• Base URL — same format as above.

Verified against GET /api/v1/partner/whoami.

Operations

Contact Get Many supports filtering by search, status, contact type, tag IDs,
list IDs, and an Updated Since timestamp for incremental syncs. Waiver
Get Many Signatures (filter by waiver, contact, event, or course) and
Affiliate Lead Get Many (filter by status or source) follow the same
Updated Since incremental-sync contract. Get Contact Status answers "has
contact X signed waiver Y?"; Get Contact Attribution returns a contact's
affiliate lead handoff rollup.

Scope

The Pewpros action node targets the Bearer-token REST surface
(/api/v1), which covers the CRM, messaging, events, and learning resources used
in automations. Not covered by a dedicated node:

• Partner API (X-Partner-Key) — facility/booking sync (customers, range
  reservations, resource bookings, orders). Use the Pewpros Partner API
  credential with n8n's HTTP Request node.
• Public funnel API (X-Tenant-Key) — anonymous lead capture and public
  event registration.

App-internal surfaces (community, push notifications, wallet passes, telephony,
QR, timers) are intentionally not exposed.

The full API is documented at pewpros.com/docs
(OpenAPI spec at /api/docs/openapi.json).

Trigger

The Pewpros Trigger node starts a workflow when a Pewpros event fires,
instead of polling. It uses the Pewpros API (Bearer) credential.

On activation it registers the workflow's webhook URL as an outbound-webhook
subscription (POST /api/v1/webhooks/register, idempotent — re-activating never
creates duplicates) and removes it on deactivation. Use Listen for test
event to receive a synthetic sample without waiting for real traffic.

Select one or more Events:

contact.created, contact.updated, registration.created,
registration.cancelled, enrollment.created, order.paid,
conversation.created, message.received, membership.created,
membership.updated, membership.cancelled.

Signature verification is on by default: each delivery carries
Pewpros-Signature: t=<unix>,v1=<hex> where
v1 = HMAC_SHA256(secret, "<t>.<rawBody>"). The node recomputes it with the
subscription secret and rejects mismatches with 401. Leave it enabled.

Poll Trigger

Waiver signatures and affiliate leads are not (yet) outbound-webhook topics, so
the Pewpros Poll Trigger node covers them by polling on the schedule you
choose in n8n's Poll Times setting:

• New Waiver Signature — optionally filtered by waiver, contact, event, or
  course.
• New Affiliate Lead — optionally filtered by status or source.

It uses the API's updated_since cursor (inclusive, ascending): each poll
fetches everything updated since the last high-water mark, advances the cursor,
and dedupes the boundary so records are emitted exactly once. The first poll
after activation sets the cursor to "now" rather than replaying history; a
manual test run returns the most recent records without moving the cursor.
Note the cursor fires on updates too — a signature or lead that is modified
later will be emitted again.

Compatibility

• Requires n8n with n8nNodesApiVersion 1 (n8n-workflow ^1.82.0).
• Node.js >=20.15.

Development

npm install
npm run build      # compile TypeScript + copy icons to dist/
npm run lint       # n8n community node lint rules
npm run dev        # tsc --watch

To test locally, link the built package into your n8n custom nodes folder and
run an n8n instance pointed at your Pewpros dev host.

Resources

• n8n community nodes documentation
• Pewpros

License

MIT