Description

n8n-nodes-crownpeak-fs

Overview

This repository provides a custom n8n integration node for the FirstSpirit REST API. It enables direct access to FirstSpirit operations such as media, page reference, template, page and script configuration within a n8n workflow.

What is it?

A n8n node module designed to simplify integration with Crownpeak FirstSpirit REST API using basic auth credential management. It supports:

• Authentication using username/password
• Manage media
• Manage pages and page references
• Manage templates and scripts
• Chain operations using dynamic expressions for automated content data pipelines

What is it for?

This module is useful for organizations looking to build automated content pipelines into the FirstSpirit ecosystem.

Supported Resources & Operations

Each method supports query parameterization using dynamic expressions and authenticates using Basic Auth.

Prerequisites

Before using this n8n community node, ensure the following components are available:

• FirstSpirit: 2025.7 or higher
• Application Server: Standalone Apache Tomcat
• Module: FirstSpirit-REST-0.0.1.fsm

Download the module from the Crownpeak download portal under custom-download/Modules/REST.
If you do not have access, please contact support@crownpeak.com.

Please refer to the README.md file for detailed setup and configuration steps.

⚠️ Important Notice

The FirstSpirit REST module is a prototype and currently under active development.

Functionality, APIs, and compatibility are subject to change without notice.
Do not use in production environments.

ℹ️ To enable communication, the FirstSpirit server must be made accessible to n8n, for example by using a tunneling tool such as ngrok.

Installation & Usage

As a Private Node

1. Clone this repository to your local machine:

   git clone https://github.com/Crownpeak/n8n-nodes-crownpeak-fs.git
   

2. Build the node module:

   cd n8n-nodes-crownpeak-fs
   npm install
   npm run build
   

3. Create a custom directory for files to use in the media endpoints. Mount it as a volume and start the n8n Docker container:

     docker run -it --rm \
    --name n8n \
    -p 5678:5678 \
    -v n8n_data:/home/node/.n8n \
    -v ~/n8n_files:/home/node/n8n_files \
    docker.n8n.io/n8nio/n8n
   

4. Copy the dist/ folder to your n8n instance's custom nodes' directory:

   docker cp ./dist n8n:/home/node/.n8n/custom/nodes/crownpeak-fs
   

5. Restart your n8n Docker container:

   docker restart n8n
   

6. Log in to n8n and the node will appear as FirstSpirit REST API.

ℹ️ If it doesn't appear, ensure you are mounting or copying to the correct container path and that NODE_FUNCTION_ALLOW_EXTERNAL is not overly restricted.

As a Community Node (once approved)

Once this node is approved and published on the official n8n integrations registry, installation will be as simple as:

n8n install n8n-nodes-crownpeak-fs

And in n8n@1.100.0+ via the UI:

1. Open Settings → Community Nodes
2. Click Install a Community Node
3. Search or paste: n8n-nodes-crownpeak-fs
4. Click Install

📸 Screenshots

1. A basic workflow example using n8n Crownpeak FS Node
   

2. The result of Create Page Template request
   

Credentials

This node supports authentication against the Crownpeak FirstSpirit REST API. You’ll need the following credentials:

• Username and Password
• Base URL of the FirstSpirit REST API

Support

• This repository is maintained by Crownpeak and released under the MIT License.
• For Crownpeak platform questions, please contact your Customer Success Manager or support@crownpeak.com.
• For n8n integration issues or pull requests, use GitHub Issues or Discussions.

License

MIT © Crownpeak Technology, Inc.
See LICENSE for details.