Registry / workflow / n8n-nodes-hypris-api

n8n-nodes-hypris-api

library0.1.44jsnpmunverified

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.

workflow database http-networking data

npm install n8n-nodes-hypris-api

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · N8N-NODES-HYPRIS-A

n8n-nodes-hypris-api

workflowjavascriptv0.1.44

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

HyprisApi

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

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

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

default

✓ import HyprisApi from 'n8n-nodes-hypris-api'

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

Default export is available. Using require with default may not work in ESM contexts.

type HyprisApiOptions

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

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

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

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);

Debug

Known issues

gotchaProperty 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.

affects: >=0.1.0

gotchaComplex 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'}.

affects: >=0.1.0

breakingPrior 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.

affects: <0.1.30

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

fix

Use 'Item' resource instead of 'ResourceItem'.

affects: >=0.1.40

gotchaBulk 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.).

affects: >=0.1.0

gotchaThe 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.

affects: >=0.1.0

breakingVersion 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.

affects: >=0.1.44

Errors

Common errors & fixes

Error: Cannot find module 'n8n-workflow'

Missing peer dependency n8n-workflow.

fix

Install n8n-workflow: npm install n8n-workflow

Authentication Failed (401): Invalid credentials

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.

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

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.

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

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.

Upgrade

Version history

0.1.44latest on npm

Audit

Dependencies

n8n-workflowrequiredRequired for n8n node runtime; peer dependency.

Agent activity

11 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Zywiol/n8n-hypris ↗

packagehttps://www.npmjs.com/package/n8n-nodes-hypris-api ↗

homepagehttps://hypris.ai ↗