n8n Introduction

Welcome to the Countertop Studio integration documentation.
This section provides a general overview of authentication, installation, and the available n8n node groups.

Authentication

All integrations with Countertop Studio require secure authentication using two headers:

• X-Api-Key – Your private API key used to authenticate requests
• X-Department-Id – Specifies which department the integration operates in

Both values are required for every API request and can be configured inside n8n using a dedicated credential.

Keep your API key secret. Never commit it to version control or expose it in frontend applications.

Installing the n8n Nodes

Our custom n8n nodes are distributed via npm.

1. Install via npm

Inside your n8n environment, run:

npm install @countertopstudio/n8n-nodes

If you are running n8n in Docker, install the package in your custom image and rebuild the container.

2. Restart n8n

After installation, restart your n8n instance so the new nodes are registered.

Once restarted, the nodes will appear in the n8n node panel under the Countertop Studio category.

Available Node Groups

Countertop Studio nodes are organized into logical groups to keep workflows clean and modular.

Create Deal (Current)

The Create Deal group is currently available and includes:

• Normalize Deal – Standardizes incoming data into the required structure
• Validate Deal – Ensures all required fields are present and valid
• Send Deal – Authenticates and transmits the deal to the API

These nodes are designed to work together as a structured pipeline:

Normalize Deal → Validate Deal → Send Deal

Future Node Groups

Additional node groups will be released over time, expanding support for more workflows and automation scenarios.

Stay tuned for updates as we continue to expand the integration capabilities.