n8n-nodes-perspective

n8n community node for Perspective.co — Funnels, CRM, metrics, and webhooks

Perspective is a mobile-first, no-code funnel builder for lead generation and sales. This package brings the full Perspective External API (CRM, metrics, workspaces) and the outgoing webhooks (new lead, funnel completed) directly into your n8n workflows.

✨ Features

• 🎯 Action node — paginated CRM, metrics & workspaces via the official REST API
• ⚡ Trigger node — receive new leads and funnel completions in real time, no API key required
• 🔍 Funnel resource locator — searchable dropdown of all your funnels, auto-loaded from /v1/workspaces
• 🤖 AI-tool ready — the action node is usableAsTool: true, so AI agents can call Perspective directly
• 🛡️ API-key auth — x-perspective-api-key header, validated against /v1/workspaces on save
• 📦 Zero runtime dependencies — no npm bloat in your n8n install

Table of contents

• Installation
• Operations
• Trigger
• Credentials
• Compatibility
• Resources
• Version history

Installation

In n8n, go to Settings → Community Nodes → Install and enter:

n8n-nodes-perspective

Or follow the community node installation guide for self-hosted installs:

npm install n8n-nodes-perspective

Operations

The Perspective action node supports three resources.

👥 Contact (CRM)

📊 Metric

All metric operations take a from / to ISO 8601 date range and an optional timezone offset (minutes).

🏢 Workspace

Trigger

The Perspective Trigger node receives outgoing webhooks from Perspective. Two events fire:

• New Lead — when a visitor submits the funnel with a completed email or phone field
• Funnel Completed — when a visitor reaches the final or any result page

Setup

1. Add a Perspective Trigger node to your workflow and activate the workflow.
2. Copy the production webhook URL from the trigger node.
3. In Perspective, open the funnel → Settings → Webhooks and add the URL for the desired event (New Lead and/or Funnel Completed). You can configure up to 3 webhooks per event.
4. Submit a test lead in Perspective → the workflow fires with the lead payload.

Payload shape

{
  "id": "contact-id",
  "funnelName": "My Lead Magnet",
  "meta": {
    "createdAt": "2026-05-07T14:32:11.000Z",
    "lastSeenAt": "2026-05-07T14:35:42.000Z",
    "completedAt": "2026-05-07T14:35:42.000Z",
    "convertedAt": "2026-05-07T14:34:08.000Z",
    "globalId": "global-contact-id"
  },
  "profile": {
    "email":      { "value": "ada@example.com",  "title": "Email" },
    "firstName":  { "value": "Ada",               "title": "First Name" },
    "phone":      { "value": "+49 …",             "title": "Phone" },
    "quiz_q1":    { "value": "Option 2",          "title": "How did you hear about us?" }
  }
}

The trigger does not require an API key — webhook URLs are the secret. Keep your workflow URL private.

Credentials

The action node requires a Perspective API credential.

1. In Perspective, go to Account Settings → API (app.perspective.co/en/settings). Only admins can create keys.
2. Create an API key (it is shown only once — save it immediately).
3. In n8n, create a new Perspective API credential and paste the key. n8n verifies it by calling GET /v1/workspaces.

The API is available from the Scale Plan (or legacy Volume Plan) onwards. The trigger node works on all plans.

Compatibility

• Tested against n8n 2.x
• Requires Node.js ≥ 22 for local development and build
• No external runtime dependencies

Resources

• 📘 Perspective External API documentation (Swagger)
• 📝 What can I do with the API App in Perspective?
• 🔔 How do I use webhooks for my funnel?
• 📚 n8n community nodes documentation

Version history

0.1.0

• Initial release: action node (Contact CRUD, Metrics KPI/Chart/Insight, Workspaces) + trigger node (New Lead, Funnel Completed)

License

MIT © Tim Querengässer