{"id":18585,"library":"n8n-nodes-hypris-api","title":"n8n Hypris API Node","description":"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.","status":"active","version":"0.1.44","language":"javascript","source_language":"en","source_url":"https://github.com/Zywiol/n8n-hypris","tags":["javascript","n8n-community-node-package","hypris"],"install":[{"cmd":"npm install n8n-nodes-hypris-api","lang":"bash","label":"npm"},{"cmd":"yarn add n8n-nodes-hypris-api","lang":"bash","label":"yarn"},{"cmd":"pnpm add n8n-nodes-hypris-api","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Required for n8n node runtime; peer dependency.","package":"n8n-workflow","optional":false}],"imports":[{"note":"This is a named export. Use ESM import for modern setups.","wrong":"const HyprisApi = require('n8n-nodes-hypris-api').HyprisApi;","symbol":"HyprisApi","correct":"import { HyprisApi } from 'n8n-nodes-hypris-api'"},{"note":"Default export is available. Using require with default may not work in ESM contexts.","wrong":"const HyprisApi = require('n8n-nodes-hypris-api');","symbol":"default","correct":"import HyprisApi from 'n8n-nodes-hypris-api'"},{"note":"This is a type export; use import type to avoid runtime errors.","wrong":"import { HyprisApiOptions } from 'n8n-nodes-hypris-api'","symbol":"type HyprisApiOptions","correct":"import type { HyprisApiOptions } from 'n8n-nodes-hypris-api'"}],"quickstart":{"code":"import { HyprisApi } from 'n8n-nodes-hypris-api';\n\nconst credentials = {\n  hyprisApiToken: process.env.HYPRIS_API_TOKEN ?? 'YOUR_TOKEN'\n};\n\nconst api = new HyprisApi(credentials);\n\n// List all workspaces\nconst workspaces = await api.listWorkspaces();\nconsole.log(workspaces);\n\n// Create an item\nconst newItem = await api.createItem({\n  workspaceId: 'ws_xxx',\n  databaseId: 'db_xxx',\n  properties: {\n    name: 'Example',\n    status: 'active',\n    link: { url: 'https://example.com' }\n  }\n});\nconsole.log(newItem);","lang":"typescript","description":"Instantiates the Hypris API node, lists workspaces, and creates an item with complex properties."},"warnings":[{"fix":"Fetch fresh workspace and database IDs from the API before each operation.","message":"Property IDs may change when resources are deleted and recreated. Using cached IDs can cause 404 errors.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Use JSON parameters mode for fields like link or relation; e.g., {'url': 'https://url.com'}.","message":"Complex column types (link, relation, people) require JSON strings or objects; plain strings may fail validation.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Upgrade to >=0.1.30 and migrate credentials to use Hypris API Token.","message":"Prior to v0.1.30, the authentication method was different and required a user ID and password instead of an API token.","severity":"breaking","affected_versions":"<0.1.30"},{"fix":"Use 'Item' resource instead of 'ResourceItem'.","message":"The 'ResourceItem' resource is deprecated in favor of 'Item' resource for CRUD operations.","severity":"deprecated","affected_versions":">=0.1.40"},{"fix":"Refer to the README for the full list of supported column types (text, number, status, dropdown, etc.).","message":"Bulk creation of properties may silently ignore unsupported column types; check documentation for supported types.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Configure credentials in n8n using the Hypris API credential type; never embed tokens in workflow code.","message":"The package uses n8n credentials system; credentials must be set via n8n UI or API, not passed directly in node code.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Upgrade n8n to version 0.200.0 or higher.","message":"Version 0.1.44 drops support for n8n versions <0.200.0 due to breaking changes in n8n-workflow peer dependency.","severity":"breaking","affected_versions":">=0.1.44"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Install n8n-workflow: npm install n8n-workflow","cause":"Missing peer dependency n8n-workflow.","error":"Error: Cannot find module 'n8n-workflow'"},{"fix":"Ensure the Hypris API Token is valid and set in the credentials. Generate a new token if necessary.","cause":"API token is incorrect or expired.","error":"Authentication Failed (401): Invalid credentials"},{"fix":"Verify the workspace ID using the 'List Workspaces' operation. IDs are regenerated when workspaces are recreated.","cause":"Workspace ID does not exist or has been deleted.","error":"Resource Not Found (404): Workspace with id 'ws_xxx' not found"},{"fix":"Ensure the item object includes a 'properties' object with the correct column values.","cause":"The item object passed to createItem is missing the 'properties' field.","error":"TypeError: Cannot read properties of undefined (reading 'properties')"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}