Description
n8n-nodes-leapter
This is an n8n community node that lets you use Leapter in your n8n workflows.
Leapter is an AI application platform that enables you to build, deploy, and manage AI blueprints. This node dynamically discovers and executes Leapter blueprints via OpenAPI specifications, providing a seamless integration between n8n workflows and Leapter’s AI capabilities.
n8n is a fair-code licensed workflow automation platform.
Table of Contents
- Installation
- Development Setup
- Operations
- Credentials
- Compatibility
- Usage
- Resources
- Version history
- Node.js: Version 20.19 – 24.x (n8n does not support Node.js 25+)
- pnpm: Package manager
Installation
Follow the installation guide in the n8n community nodes documentation.
Development Setup
Prerequisites
To check your Node.js version:
node -v
If you need to switch versions using Homebrew:
brew install node@24
brew unlink node
brew link --overwrite node@24
Install Dependencies
pnpm install
Scripts
| Script | Description |
|——–|————-|
| pnpm dev | Start n8n with the node in development mode (with hot reload) |
| pnpm build | Build the node for production |
| pnpm build:watch | Build and watch for changes |
| pnpm lint | Run ESLint |
| pnpm lint:fix | Fix linting issues |
Releases are cut from the GitHub Releases UI: draft a release with a vX.Y.Z tag and publish it. The version is taken from the tag (see .github/workflows/publish.yml); the version field in package.json is a placeholder.
Running Locally
1. Install dependencies:
pnpm install
2. Start the development server:
pnpm dev
3. Open n8n in your browser:
http://localhost:5678
The Leapter node will be available in the n8n node picker.
Operations
The Leapter node provides dynamic operations based on your available blueprints:
How It Works
1. Select a Project from your available Leapter projects
2. Choose an Operation (blueprint) to execute
3. Configure input parameters using either:
– Visual Mode: Map fields visually with type hints
– JSON Mode: Provide raw JSON input for advanced use cases
4. Execute and receive results with metadata including run ID and editor link
Credentials
To use this node, you need a Leapter API key.
Prerequisites
1. Sign up for a Leapter account at lab.leapter.com
2. Create at least one project with published blueprints
Setting Up Credentials
1. In Leapter, go to Settings → API Keys
2. Click Create API Key
3. Copy the generated key (starts with lpt_)
4. In n8n, create new credentials for “Leapter API”
5. Paste your API key
6. (Optional) Change the server URL if using a self-hosted instance
Credential Fields
| Field | Description | Required |
|——-|————-|———-|
| API Key | Your Leapter API key (starts with lpt_) | Yes |
| Leapter Server | Server URL (default: https://lab.leapter.com) | No |
Compatibility
Usage
Visual Mode (Recommended)
Visual mode provides a guided experience with field-by-field mapping:
1. Select your project and operation
2. The node automatically loads available input fields
3. Map values from previous nodes or enter static values
4. Each field shows its type and whether it’s required
JSON Mode
For advanced users or complex payloads:
1. Select your project and operation
2. Switch Input Mode to “JSON”
3. Enter your parameters as a JSON object
4. Refer to the OpenAPI spec for field definitions
Example Workflow
Trigger → Leapter (Execute Blueprint) → Process Results
Output
The node returns:
– runId: Unique identifier for the execution
– editorLink: Direct link to view the run in Leapter
