@rjsebening/n8n-nodes-salessuite 0.0.5

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright 2026 n8n
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+# n8n-nodes-salessuite
+
+![n8n Community Node](https://img.shields.io/badge/n8n-community--node-FF6D5A)
+![Version](https://img.shields.io/badge/version-1.0.0-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+
+### n8n Integration for **SalesSuite – the best CRM built on the Setter-Closer principle**
+
+Automate your contact, deal, and activity workflows, react to real-time events, and keep your pipeline moving — **without manual work**.
+
+
+## 🧭 Overview
+
+This community node connects **SalesSuite (Setter-Closer CRM)** seamlessly with your n8n workflows.
+From contact creation to deal management and real-time triggers — automate every key revenue process end-to-end.
+
+## ⚙️ Key Capabilities
+
+### 👤 Contacts
+
+| Action                    | Description                                                          |
+| ------------------------- | -------------------------------------------------------------------- |
+| **Create Contact**        | Add a new contact (standard create, no upsert logic).                |
+| **Find Contact by Email** | Retrieve contacts using their email address.                         |
+| **Get Contact by ID**     | Fetch a specific contact using its unique ID.                        |
+| **List Contacts**         | Browse contacts with pagination support.                             |
+| **Search Contacts**       | Perform text-based search across contacts.                           |
+| **Update Contact**        | Modify contact details by ID.                                        |
+| **Upsert Contact**        | Search by email and update if found, otherwise create a new contact. |
+
+---
+
+### 💼 Deals
+
+| Action                  | Description                                                                 |
+| ----------------------- | --------------------------------------------------------------------------- |
+| **Create Deal**         | Add a new deal to a selected pipeline and phase.                            |
+| **Find Deal by ID**     | Retrieve a deal using its ID.                                               |
+| **Find Deals by Email** | Get all deals connected to a contact’s email.                               |
+| **List Deals**          | View deals with pagination (optional filtering by pipeline).                |
+| **List Pipelines**      | Retrieve available pipelines along with their phases.                       |
+| **Update Deal**         | Update deal properties and optionally move it to another phase or pipeline. |
+
+---
+
+### 📝 Activities
+
+| Action                    | Description                                    |
+| ------------------------- | ---------------------------------------------- |
+| **Create Note**           | Add an internal note to a contact record.      |
+| **List Email Activities** | Retrieve email-related activity for a contact. |
+| **List Call Activities**  | Retrieve call activity linked to a contact.    |
+
+---
+
+### 🔔 Webhooks
+
+| Action             | Description                            |
+| ------------------ | -------------------------------------- |
+| **List Webhooks**  | View all active webhook subscriptions. |
+| **Create Webhook** | Register a new webhook subscription.   |
+| **Update Webhook** | Modify an existing webhook.            |
+| **Delete Webhook** | Remove a webhook subscription.         |
+
+---
+
+### ⚡ Real-Time Triggers
+
+| Event                        | Description                                 |
+| ---------------------------- | ------------------------------------------- |
+| **Contact Created**          | Fires when a new contact is added.          |
+| **Contact Property Changed** | Fires when a contact field changes.         |
+| **Deal Created**             | Fires when a new deal is created.           |
+| **Deal Property Changed**    | Fires when a deal field changes.            |
+| **Deal Stage Changed**       | Fires when a deal moves to another phase.   |
+| **Form Submitted**           | Fires on form submission.                   |
+| **Call Activity Created**    | Fires when a new call activity is recorded. |
+
+---
+
+## 🔐 Authentication
+
+The node uses **API Key authentication**.
+
+* Base endpoint: `https://api.salessuite.com/api/v1`
+* Required header:
+
+  ```
+  x-api-key: <YOUR_API_KEY>
+  ```
+
+A built-in credential test within n8n ensures your API key is valid before running workflows.
+
+---
+
+## 📦 Installation
+
+### Requirements
+
+* n8n version **2.0.0 or higher**
+* Active SalesSuite account with a valid API key
+
+### Community Node Installation
+
+1. Open n8n → **Settings → Community Nodes → Install**
+2. Enter package name:
+
+```bash
+# Option A — Scoped (recommended)
+@rjsebening/n8n-nodes-salessuite
+
+# Option B — Unscoped
+n8n-nodes-salessuite
+```
+
+3. **Restart n8n** – the node will now appear in the list.
+
+
+
+## 📬 About the Author
+
+I’m **[Rezk Jörg Sebening](https://github.com/rjsebening)** – Automation & Systems Expert (DACH).
+I build n8n nodes and process automation systems that help agencies, coaches, and service providers scale **without manual work**.
+
+👉 Follow me on GitHub for new DACH integrations and automation templates.
+
+## ⚖️ Legal Disclaimer
+
+This community node is **not affiliated with SalesSuite** (no partnership, no sponsorship, no official endorsement).
+It simply connects to publicly available API endpoints.
+
+* Community developed & maintained
+* For API-related issues → contact **SalesSuite Support**
+* All trademarks & logos belong to their respective owners
+
+## 📄 License
+
+**MIT License**
+Contributions and pull requests are welcome!

package/dist/credentials/SalesSuiteApi.credentials.d.ts

@@ -0,0 +1,14 @@
+import type { IAuthenticateGeneric, ICredentialType, INodeProperties } from "n8n-workflow";
+export declare class SalesSuiteApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    authenticate: IAuthenticateGeneric;
+    properties: INodeProperties[];
+    test: {
+        request: {
+            method: "GET";
+            url: string;
+        };
+    };
+}

package/dist/credentials/SalesSuiteApi.credentials.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalesSuiteApi = void 0;
+class SalesSuiteApi {
+    constructor() {
+        this.name = "salesSuiteApi";
+        this.displayName = "SalesSuite API";
+        this.documentationUrl = "https://api.salessuite.com";
+        this.authenticate = {
+            type: "generic",
+            properties: {
+                headers: {
+                    "x-api-key": "={{$credentials.apiKey}}",
+                },
+            },
+        };
+        this.properties = [
+            {
+                displayName: "API Base URL",
+                name: "baseUrl",
+                type: "string",
+                default: "https://api.salessuite.com/api/v1",
+                placeholder: "https://api.salessuite.com/api/v1",
+                description: "Base URL of the SalesSuite Public API",
+            },
+            {
+                displayName: "API Key",
+                name: "apiKey",
+                type: "string",
+                typeOptions: { password: true },
+                default: "",
+                description: "SalesSuite API Key",
+            },
+        ];
+        this.test = {
+            request: {
+                method: "GET",
+                url: "={{$credentials.baseUrl}}/pipelines",
+            },
+        };
+    }
+}
+exports.SalesSuiteApi = SalesSuiteApi;

package/dist/nodes/SalesSuite/SalesSuite.node.d.ts

@@ -0,0 +1,37 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from "n8n-workflow";
+import { getContactResourceMapperFields, getContactResourceMapperFieldsForUpdate } from "./methods/resourceMappers/contact.resourceMapper";
+import { getDealResourceMapperFields, getDealResourceMapperFieldsForUpdate } from "./methods/resourceMappers/deal.resourceMapper";
+export declare class SalesSuite implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            loadPhoneCallActivityTypes(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            loadCallResultTypes(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            getWebhookTriggers(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<{
+                name: string;
+                value: string;
+                description?: string;
+            }[]>;
+            getWebhooksAsOptions(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<{
+                name: string;
+                value: string;
+            }[]>;
+            getFormsAsOptions(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<{
+                name: string;
+                value: string;
+            }[]>;
+            getWebhookProperties(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            getDeals(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            getPipelines(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            getStagesByPipeline(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            getContacts(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+        };
+        resourceMapping: {
+            getContactResourceMapperFields: typeof getContactResourceMapperFields;
+            getContactResourceMapperFieldsForUpdate: typeof getContactResourceMapperFieldsForUpdate;
+            getDealResourceMapperFields: typeof getDealResourceMapperFields;
+            getDealResourceMapperFieldsForUpdate: typeof getDealResourceMapperFieldsForUpdate;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/SalesSuite/SalesSuite.node.js

@@ -0,0 +1,120 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalesSuite = void 0;
+const activity_1 = require("./actions/activity");
+const apiCall_1 = require("./actions/apiCall");
+const contact_1 = require("./actions/contact");
+const deal_1 = require("./actions/deal");
+const resource_selector_1 = require("./actions/resource.selector");
+const router_1 = require("./actions/router");
+const webhook_1 = require("./actions/webhook");
+const Loaders = __importStar(require("./methods/loadOptions"));
+const contact_resourceMapper_1 = require("./methods/resourceMappers/contact.resourceMapper");
+const deal_resourceMapper_1 = require("./methods/resourceMappers/deal.resourceMapper");
+class SalesSuite {
+    constructor() {
+        this.description = {
+            displayName: "SalesSuite",
+            name: "salesSuite",
+            icon: {
+                light: "file:salessuite-light-icon.svg",
+                dark: "file:salessuite-dark-icon.svg",
+            },
+            group: ["transform"],
+            version: 1,
+            description: "Interact with the SalesSuite API (powered by agentur-systeme.de)",
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            defaults: {
+                name: "SalesSuite",
+                description: "Interact with the SalesSuite API (powered by agentur-systeme.de)",
+            },
+            inputs: [{ type: "main" }],
+            outputs: [{ type: "main" }],
+            credentials: [{ name: "salesSuiteApi", required: true }],
+            usableAsTool: true,
+            properties: [
+                resource_selector_1.resourceSelector,
+                ...activity_1.activityOperations,
+                ...activity_1.activityFields,
+                ...apiCall_1.apiCallOperations,
+                ...apiCall_1.apiCallFields,
+                ...contact_1.contactOperations,
+                ...contact_1.contactFields,
+                ...deal_1.dealOperations,
+                ...deal_1.dealFields,
+                ...webhook_1.webhookOperations,
+                ...webhook_1.webhookFields,
+            ],
+        };
+        this.methods = {
+            loadOptions: {
+                ...Loaders.commonLoaders,
+                ...Loaders.contactLoaders,
+                ...Loaders.dealLoaders,
+                ...Loaders.webhookLoaders,
+                ...Loaders.phoneCallLoaders,
+            },
+            resourceMapping: {
+                getContactResourceMapperFields: contact_resourceMapper_1.getContactResourceMapperFields,
+                getContactResourceMapperFieldsForUpdate: contact_resourceMapper_1.getContactResourceMapperFieldsForUpdate,
+                getDealResourceMapperFields: deal_resourceMapper_1.getDealResourceMapperFields,
+                getDealResourceMapperFieldsForUpdate: deal_resourceMapper_1.getDealResourceMapperFieldsForUpdate,
+            },
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            const resource = this.getNodeParameter("resource", i);
+            const operation = this.getNodeParameter("operation", i);
+            const result = (await router_1.route.call(this, i, resource, operation));
+            if (Array.isArray(result)) {
+                for (const entry of result) {
+                    returnData.push(entry);
+                }
+            }
+            else if (result && typeof result === "object") {
+                returnData.push(result);
+            }
+            else {
+                returnData.push({ result });
+            }
+        }
+        return [this.helpers.returnJsonArray(returnData)];
+    }
+}
+exports.SalesSuite = SalesSuite;

package/dist/nodes/SalesSuite/SalesSuite.node.json

@@ -0,0 +1,18 @@
+{
+    "node": "n8n-nodes-base.salessuite",
+    "nodeVersion": "1.0.0",
+    "codexVersion": "1.0",
+    "categories": ["Sales", "Communication"],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://github.com/rjsebening/n8n-nodes-salessuite/blob/main/CREDENTIALS.md"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/rjsebening/n8n-nodes-salessuite/blob/main/README.md"
+            }
+        ]
+    }
+}

package/dist/nodes/SalesSuite/actions/activity/activity.actions.d.ts

@@ -0,0 +1,2 @@
+import { IExecuteFunctions } from "n8n-workflow";
+export declare function handleActivity(this: IExecuteFunctions, i: number, operation: string): Promise<unknown>;

package/dist/nodes/SalesSuite/actions/activity/activity.actions.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleActivity = handleActivity;
+const n8n_workflow_1 = require("n8n-workflow");
+const apiclient_1 = require("../../helpers/apiclient");
+const notes_1 = require("../../helpers/notes");
+async function handleActivity(i, operation) {
+    switch (operation) {
+        case "createNote": {
+            const contactId = this.getNodeParameter("contactId", i);
+            const noteText = this.getNodeParameter("noteText", i, "");
+            const pinNote = this.getNodeParameter("pinNote", i, false);
+            const makeBold = this.getNodeParameter("makeBold", i, false);
+            const noteId = await (0, notes_1.createNoteWithOptionalPin)(this, contactId, noteText, pinNote, makeBold, "contact");
+            return {
+                parentType: "contact",
+                parentId: contactId,
+                noteId: noteId !== null && noteId !== void 0 ? noteId : null,
+            };
+        }
+        case "listEmailActivities": {
+            const contactId = this.getNodeParameter("contactId", i);
+            const data = await (0, apiclient_1.ssRequest)(this, "POST", "/get-mail-activities", {
+                body: { contactId },
+            });
+            return { scope: "contact", parentId: contactId, activities: data !== null && data !== void 0 ? data : [] };
+        }
+        case "listPhoneCallActivities": {
+            const contactId = this.getNodeParameter("contactId", i);
+            const callTypeId = this.getNodeParameter("phoneCallActivityTypeId", i, "").trim();
+            const callResult = this.getNodeParameter("callResult", i, "").trim();
+            const body = { contactId };
+            if (callTypeId && callTypeId !== "any")
+                body.callTypeId = callTypeId;
+            if (callResult && callResult !== "any") {
+                try {
+                    body.callResult = JSON.parse(callResult);
+                }
+                catch {
+                    body.callResult = callResult;
+                }
+            }
+            const data = await (0, apiclient_1.ssRequest)(this, "POST", "/get-call-activities", {
+                body: body,
+            });
+            return { scope: "contact", parentId: contactId, activities: data !== null && data !== void 0 ? data : [] };
+        }
+        default:
+            throw new n8n_workflow_1.ApplicationError(`Unsupported activity operation: ${operation}`);
+    }
+}

package/dist/nodes/SalesSuite/actions/activity/index.d.ts

@@ -0,0 +1,3 @@
+import { INodeProperties } from "n8n-workflow";
+export declare const activityOperations: INodeProperties[];
+export declare const activityFields: INodeProperties[];

package/dist/nodes/SalesSuite/actions/activity/index.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activityFields = exports.activityOperations = void 0;
+exports.activityOperations = [
+    {
+        displayName: "Operation",
+        name: "operation",
+        type: "options",
+        noDataExpression: true,
+        displayOptions: { show: { resource: ["activity"] } },
+        options: [
+            {
+                name: "Create Note",
+                value: "createNote",
+                action: "Create note on contact",
+                description: "Add an internal note to a contact",
+            },
+            {
+                name: "List Email Activities",
+                value: "listEmailActivities",
+                action: "List contact emails",
+                description: "Retrieve a history of emails for the selected contact",
+            },
+            {
+                name: "List Phone Call Activities",
+                value: "listPhoneCallActivities",
+                action: "List contact calls",
+                description: "Retrieve logged phone call activities related to the contact",
+            },
+        ],
+        default: "createNote",
+    },
+];
+exports.activityFields = [
+    {
+        displayName: "Contact Name or ID",
+        name: "contactId",
+        type: "options",
+        typeOptions: { loadOptionsMethod: "getContacts" },
+        required: true,
+        default: "",
+        displayOptions: {
+            show: {
+                resource: ["activity"],
+                operation: [
+                    "createNote",
+                    "listEmailActivities",
+                    "listPhoneCallActivities",
+                ],
+            },
+        },
+        description: 'Choose the contact. Choose from the list, or specify an ID using an expression. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+    },
+    {
+        displayName: "Note Text",
+        name: "noteText",
+        type: "string",
+        typeOptions: { rows: 4 },
+        default: "",
+        displayOptions: {
+            show: { resource: ["activity"], operation: ["createNote"] },
+        },
+        description: "Plain text note",
+    },
+    {
+        displayName: "Pin Note?",
+        name: "pinNote",
+        type: "boolean",
+        default: false,
+        displayOptions: {
+            show: { resource: ["activity"], operation: ["createNote"] },
+        },
+    },
+    {
+        displayName: "Bold Text?",
+        name: "makeBold",
+        type: "boolean",
+        default: false,
+        displayOptions: {
+            show: { resource: ["activity"], operation: ["createNote"] },
+        },
+    },
+    {
+        displayName: "Call Type Name or ID",
+        name: "phoneCallActivityTypeId",
+        type: "options",
+        typeOptions: { loadOptionsMethod: "loadPhoneCallActivityTypes" },
+        default: "any",
+        displayOptions: {
+            show: { resource: ["activity"], operation: ["listPhoneCallActivities"] },
+        },
+        description: 'Optional filter by call type. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+    },
+    {
+        displayName: "Call Result Name or ID",
+        name: "callResult",
+        type: "options",
+        typeOptions: {
+            loadOptionsMethod: "loadCallResultTypes",
+            loadOptionsDependsOn: ["phoneCallActivityTypeId"],
+        },
+        default: "any",
+        displayOptions: {
+            show: { resource: ["activity"], operation: ["listPhoneCallActivities"] },
+        },
+        description: 'Optional filter by call result. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+    },
+];

package/dist/nodes/SalesSuite/actions/apiCall/apiCall.actions.d.ts

@@ -0,0 +1,2 @@
+import { IExecuteFunctions } from "n8n-workflow";
+export declare function handleApiCall(this: IExecuteFunctions, i: number, operation: string): Promise<unknown>;

package/dist/nodes/SalesSuite/actions/apiCall/apiCall.actions.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleApiCall = handleApiCall;
+const n8n_workflow_1 = require("n8n-workflow");
+const apiclient_1 = require("../../helpers/apiclient");
+async function handleApiCall(i, operation) {
+    var _a;
+    switch (operation) {
+        case "makeRequest": {
+            const method = this.getNodeParameter("httpMethod", i);
+            const endpoint = this.getNodeParameter("endpoint", i);
+            const queryParams = (_a = this.getNodeParameter("queryParameters", i)) === null || _a === void 0 ? void 0 : _a.parameter;
+            const qs = {};
+            for (const param of queryParams !== null && queryParams !== void 0 ? queryParams : []) {
+                if (param.name && param.value !== undefined) {
+                    qs[param.name] = param.value;
+                }
+            }
+            let body;
+            if (["POST", "PUT", "PATCH"].includes(method)) {
+                const rawBody = this.getNodeParameter("requestBody", i, {});
+                body = typeof rawBody === "string" ? JSON.parse(rawBody) : rawBody;
+            }
+            return (0, apiclient_1.ssRequest)(this, method, endpoint, { qs, body });
+        }
+        default:
+            throw new n8n_workflow_1.ApplicationError(`Unsupported operation: ${operation}`);
+    }
+}

package/dist/nodes/SalesSuite/actions/apiCall/index.d.ts

@@ -0,0 +1,3 @@
+import type { INodeProperties } from "n8n-workflow";
+export declare const apiCallOperations: INodeProperties[];
+export declare const apiCallFields: INodeProperties[];