n8n Hypris API Node

0.1.44 verified Sat Apr 25 auth: no javascript

n8n-nodes-hypris-api v0.1.44 is a community node package for n8n that integrates with the Hypris enterprise workflow and database management platform. It provides nodes for authenticating and performing CRUD operations on workspaces, databases, items (records), properties (columns), and views. Notable features include auto-mapping of complex column types (link, relation, people, location, formula, date) and bulk creation of status/dropdown options. The package is actively maintained and depends on n8n-workflow. Current release cadence is irregular. Differentiators include specialized support for Hypris-specific data types, while alternatives like generic HTTP nodes require manual handling.

Common errors

error Error: Cannot find module 'n8n-workflow' ↓

cause Missing peer dependency n8n-workflow.

fix

Install n8n-workflow: npm install n8n-workflow

error Authentication Failed (401): Invalid credentials ↓

cause API token is incorrect or expired.

fix

Ensure the Hypris API Token is valid and set in the credentials. Generate a new token if necessary.

error Resource Not Found (404): Workspace with id 'ws_xxx' not found ↓

cause Workspace ID does not exist or has been deleted.

fix

Verify the workspace ID using the 'List Workspaces' operation. IDs are regenerated when workspaces are recreated.

error TypeError: Cannot read properties of undefined (reading 'properties') ↓

cause The item object passed to createItem is missing the 'properties' field.

fix

Ensure the item object includes a 'properties' object with the correct column values.

Warnings

gotcha Property IDs may change when resources are deleted and recreated. Using cached IDs can cause 404 errors. ↓

fix Fetch fresh workspace and database IDs from the API before each operation.

gotcha Complex column types (link, relation, people) require JSON strings or objects; plain strings may fail validation. ↓

fix Use JSON parameters mode for fields like link or relation; e.g., {'url': 'https://url.com'}.

breaking Prior to v0.1.30, the authentication method was different and required a user ID and password instead of an API token. ↓

fix Upgrade to >=0.1.30 and migrate credentials to use Hypris API Token.

deprecated The 'ResourceItem' resource is deprecated in favor of 'Item' resource for CRUD operations. ↓

fix Use 'Item' resource instead of 'ResourceItem'.

gotcha Bulk creation of properties may silently ignore unsupported column types; check documentation for supported types. ↓

fix Refer to the README for the full list of supported column types (text, number, status, dropdown, etc.).

gotcha The package uses n8n credentials system; credentials must be set via n8n UI or API, not passed directly in node code. ↓

fix Configure credentials in n8n using the Hypris API credential type; never embed tokens in workflow code.

breaking Version 0.1.44 drops support for n8n versions <0.200.0 due to breaking changes in n8n-workflow peer dependency. ↓

fix Upgrade n8n to version 0.200.0 or higher.

Install

npm install n8n-nodes-hypris-api

yarn add n8n-nodes-hypris-api

pnpm add n8n-nodes-hypris-api

Imports

HyprisApi

wrong

const HyprisApi = require('n8n-nodes-hypris-api').HyprisApi;

correct

import { HyprisApi } from 'n8n-nodes-hypris-api'

This is a named export. Use ESM import for modern setups.

default
wrong
```
const HyprisApi = require('n8n-nodes-hypris-api');
```
correct
```
import HyprisApi from 'n8n-nodes-hypris-api'
```
Default export is available. Using require with default may not work in ESM contexts.

type HyprisApiOptions

wrong

import { HyprisApiOptions } from 'n8n-nodes-hypris-api'

correct

import type { HyprisApiOptions } from 'n8n-nodes-hypris-api'

This is a type export; use import type to avoid runtime errors.

Quickstart

Instantiates the Hypris API node, lists workspaces, and creates an item with complex properties.

import { HyprisApi } from 'n8n-nodes-hypris-api';

const credentials = {
  hyprisApiToken: process.env.HYPRIS_API_TOKEN ?? 'YOUR_TOKEN'
};

const api = new HyprisApi(credentials);

// List all workspaces
const workspaces = await api.listWorkspaces();
console.log(workspaces);

// Create an item
const newItem = await api.createItem({
  workspaceId: 'ws_xxx',
  databaseId: 'db_xxx',
  properties: {
    name: 'Example',
    status: 'active',
    link: { url: 'https://example.com' }
  }
});
console.log(newItem);