npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

n8n-nodes-ziflow

v1.1.1

Published

Complete ZiFlow API community nodes with native fields and advanced JSON input

Downloads

333

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

cderamos-2ctcderamos-2ct

Keywords

n8n-community-node-packageziflowproofingproofreview

Readme

n8n-nodes-ziflow

Community node package for integrating n8n with the ZiFlow proof-management API.

This repository ships the legacy compatibility ZiFlow node, split ZiFlow domain nodes, one credential type, compiled runtime files under dist/, and documentation for the live workflow compatibility contract. The split nodes map all 104 operations in the current official ZiFlow OpenAPI contract.

Install | Credentials | Node Layout | Repository Structure | Build Semantics | Compatibility Contract | API Mapping | Validation

Install

n8n Community Nodes

In n8n:

  1. Go to Settings > Community Nodes.
  2. Select Install a community node.
  3. Enter n8n-nodes-ziflow.
  4. Install and restart n8n.

Manual Install

npm install n8n-nodes-ziflow

For repository development:

npm install
npm run build

Credentials

Credential type: ziFlowApi

Defined in credentials/ZiFlowApi.credentials.ts.

| Field | Purpose | | --- | --- | | API Key | ZiFlow API key sent in the apikey header | | Base URL | ZiFlow API base URL, usually https://api.ziflow.io |

Node Layout

Existing workflows continue to use the original ZiFlow node (n8n-nodes-ziflow.ziFlow). New workflows should use the split domain nodes:

| Node | Scope | | --- | --- | | ZiFlow | Legacy compatibility node for saved workflows | | ZiFlow Proofs | Proofs, stages, reviewers, proof checklists, proof exports | | ZiFlow Folders | Folders, folder sharing, folder URLs | | ZiFlow Comments | Comments, reactions, labels, resolution | | ZiFlow People | Users, contacts, guests, SCIM users | | ZiFlow Templates | Workflow templates and checklist templates | | ZiFlow Webhooks | Webhook subscriptions | | ZiFlow Admin | Custom properties, decision settings, integrations, intake forms | | ZiFlow API Request | Authenticated escape hatch for any ZiFlow path |

Each split domain node offers two input styles:

  • Native Fields is the default. The selected operation shows its documented path fields, query filters, and nested request-body fields directly in n8n.
  • Advanced JSON exposes the full path, query, or body object when a workflow needs a dynamic payload or a newly introduced API value.

Saved split-node workflows that already contain pathParametersJson, queryParametersJson, or bodyJson continue to execute in compatibility mode without requiring a workflow edit.

Repository Structure

Important tracked files and runtime outputs:

  • README.md
  • README_TEMPLATE.md
  • CHANGELOG.md
  • CODE_OF_CONDUCT.md
  • LICENSE.md
  • package.json
  • tsconfig.json
  • eslint.config.mjs
  • credentials/ZiFlowApi.credentials.ts
  • credentials/ziflow.svg
  • credentials/ziflow.dark.svg
  • icons/ziflow.svg
  • nodes/ZiFlow/ZiFlow.node.ts
  • nodes/ZiFlow/ZiFlowProofs.node.ts
  • nodes/ZiFlow/ZiFlowFolders.node.ts
  • nodes/ZiFlow/ZiFlowComments.node.ts
  • nodes/ZiFlow/ZiFlowPeople.node.ts
  • nodes/ZiFlow/ZiFlowTemplates.node.ts
  • nodes/ZiFlow/ZiFlowWebhooks.node.ts
  • nodes/ZiFlow/ZiFlowAdmin.node.ts
  • nodes/ZiFlow/ZiFlowApiRequest.node.ts
  • nodes/ZiFlow/shared/ZiFlowOpenApiContract.ts
  • nodes/ZiFlow/shared/ZiFlowDomainNode.ts
  • nodes/ZiFlow/ziflow.svg
  • dist/credentials/ZiFlowApi.credentials.js
  • dist/credentials/ZiFlowApi.credentials.d.ts
  • dist/credentials/ziflow.svg
  • dist/nodes/ZiFlow/ZiFlow.node.js
  • dist/nodes/ZiFlow/ZiFlow.node.d.ts
  • dist/nodes/ZiFlow/ziflow.svg
  • docs/API_CONTRACT_MAPPING.md
  • docs/BUILD_AND_RELEASE.md
  • docs/WORKFLOW_COMPATIBILITY.md
  • nodes/ZiFlow/README.md

Build Semantics

Build command:

npm run build

Current build script uses the official n8n node tool:

npm run n8n-node:build

Development watch script:

node ./node_modules/typescript/bin/tsc --watch

The split-node package also includes public:export and public:scan scripts for producing a sanitized public customer package from the private maintenance repo.

Package manifest semantics:

| Field | Current value | | --- | --- | | Package | n8n-nodes-ziflow | | Runtime node entries | dist/nodes/ZiFlow/*.node.js | | Runtime credential entry | dist/credentials/ZiFlowApi.credentials.js | | Source node | nodes/ZiFlow/ZiFlow.node.ts | | Source credential | credentials/ZiFlowApi.credentials.ts | | Icon | bundled file:ziflow.svg / file:ziflow.dark.svg |

More detail: Build and Release.

Runtime Semantics

The node executes one n8n input item at a time.

  1. Reads API Key and Base URL from ziFlowApi credentials.
  2. Normalizes Base URL by trimming a trailing slash.
  3. Sends REST requests through n8n credential authentication.
  4. Builds requestOptions per resource and operation, then calls httpRequestWithAuthentication.
  5. Returns response data to n8n or throws NodeOperationError on failure.

Compatibility Contract

This node is used by saved workflows in the live n8n instance. Backward compatibility includes node identity, declared versions, resource values, operation values, parameter names, icon loading, and editor hydration.

| Field | Value | | --- | --- | | Display name | ZiFlow | | Internal node name | ziFlow | | Runtime workflow type | n8n-nodes-ziflow.ziFlow | | Declared versions | [10] | | Credential type | ziFlowApi | | Saved workflow usage | 11 saved ZiFlow nodes currently use typeVersion 10 in the live n8n database. |

Do not change these values without a saved-workflow migration and browser/editor validation.

More detail: Workflow Compatibility.

API Mapping

The current official ZiFlow OpenAPI contract is mapped in API Contract Mapping. That document maps 104 official operations to split domain nodes and is the first file to diff when ZiFlow changes its API.

Operations

The legacy node still exposes its existing broad resource and operation values for workflow compatibility. New development should use the split domain nodes and the mapping document above.

| Resource Display | Resource Value | Operations | | --- | --- | --- | | Folder | folder | list, get, getSubfolders, create, update, delete, archive, unarchive, move, search, getFolderUrl, getShare, updateShare | | Proof | proof | list, get, create, update, delete, archive, getProofUrl, getReviewUrl, addFile, uploadFile, listFiles, lock, unlock, listVersions, copy, search, searchActivity, getActivities, deleteAllVersions, disconnectVersion, getEmails, addIntegrationProperties, updateIntegrationProperties, makeDecision, exportSummaryPdf, exportSummaryPdfWebhook, getSummaryPdfExportStatus, exportCommentsPdf, exportCommentsPdfWebhook, getCommentsPdfExportStatus | | File | file | list, get, upload, download, update, delete | | Review | review | list, get, submit, update, delete, getAllForProof | | Comment | comment | list, get, add, update, reply, delete, label, like, addReactions, resolve | | Reviewer | reviewer | list, get, add, update, remove | | Webhook | webhook | list, get, create, update, delete, test | | Template | template | list, get, create, update, delete | | Version | version | list, get, compare, restore | | User | user | list, get, create, update, delete, invite | | Team | team | list, get, create, update, delete, addMember, removeMember | | Workflow Stage | workflowStage | list, get, create, update, delete | | Decision | decision | list, get, submit, update | | Comment Label | commentLabel | list, get, create, update, delete | | Contact | contact | list, get | | Checklist Template | checklistTemplate | list, create, get, delete | | Decision Checklist | decisionChecklist | get, update, addOption, getOption, updateOption, deleteOption | | Decision Reason | decisionReason | get, update, addOption, getOption, updateOption, deleteOption | | Guest | guest | add, update, delete | | Intake Form | intakeForm | list | | Integration | integration | list, getConnections, getPropertyGroups, getPropertyGroupProperties | | Workflow Template | workflowTemplate | list, get, create, update, delete | | SCIM User | scimUser | list, get, create, update | | Custom Property | customProperty | listGroups, getGroup, createGroup, updateGroup, deleteGroup, getPropertyOptions, addPropertyOption, getPropertyOption, updatePropertyOption | | Proof Stage | proofStage | updateStage, startStage, setFinalStatus, addReviewer, getReviewer, updateReviewer, deleteReviewer, addChecklists, getChecklist, markChecklistItem | | API Request | apiRequest | make |

Service Notes

  • ZiFlow already declares version 10, matching live saved workflows.
  • Many resources are mutating proof, review, webhook, team, user, and decision state; validate with read operations first.
  • API Request is an authenticated escape hatch under the configured ZiFlow API base URL for endpoints not promoted to first-class operations yet.
  • The repo previously still had starter README content; this documentation replaces that with node-specific runtime details.

Validation

Minimum local validation:

npm test
npm run lint
npm audit --omit=dev --omit=peer
npm pack --dry-run

Minimum live validation after deployment:

  1. Confirm n8n health is green.
  2. Confirm n8n is loading the intended package commit.
  3. Confirm the public icon route returns SVG.
  4. Query saved workflows for n8n-nodes-ziflow.ziFlow nodes.
  5. Validate saved typeVersion values against declared versions.
  6. Validate saved resource and operation values against current option lists.
  7. Open representative workflows in the n8n editor and verify icon, subtitle, resource, operation, and required fields.

Do not skip browser/editor validation after large node builds.

Related Docs

License

See the repository license file.