n8n-nodes-subnoto

n8n community node to integrate with Subnoto for document signing. Uses the Subnoto TypeScript SDK.

Installation

The built package is published on npm. To use this custom node on your personal (self-hosted) n8n instance:

From the n8n UI (recommended)

1. In n8n, go to Settings → Community Nodes → Install.
2. Enter the package name: @subnoto/n8n-nodes-subnoto.
3. Optionally specify a version (e.g. @subnoto/[email protected]), then install.
4. Restart n8n when prompted. The Subnoto node will appear in your node list.

Manual install (CLI / Docker)

If your instance runs in queue mode or you prefer installing via the command line:

1. Install the package in n8n’s custom nodes directory:

   mkdir -p ~/.n8n/nodes
   cd ~/.n8n/nodes
   npm install @subnoto/n8n-nodes-subnoto

   For Docker: run the same commands inside the container (e.g. docker exec -it n8n sh), or use an image that installs this package and set N8N_CUSTOM_EXTENSIONS to the path where it’s installed.

2. Tell n8n to load custom nodes by setting N8N_CUSTOM_EXTENSIONS to that directory before starting n8n:

   export N8N_CUSTOM_EXTENSIONS="/path/to/.n8n/nodes"
   n8n start

   (Use ~/.n8n/nodes or the path where you ran npm install.)

3. Restart n8n. Add a Subnoto API credential and use the Subnoto node in your workflows.

Community node installation is only available on self-hosted n8n, not on n8n Cloud.

Operations

• Upload Document - Upload a PDF or Word document and create an envelope.
• Add Recipients - Add recipients to an envelope.
• Add Blocks - Add signature blocks to a document.
• Send - Send the envelope to recipients.
• List Workspaces - List all workspaces the API key owner is a member of.

Credentials

Create a Subnoto API credential with:

• API Base URL - e.g. https://enclave.subnoto.com
• Access Key - Your API access key
• Secret Key - Your API secret key
• Unattested Mode - Optional (default: false)

Development

Using the Dev Container

1. Open the project in VS Code (or Cursor) and Reopen in Container (Dev Containers extension).
2. After the container is built, dependencies are installed and the project is built automatically (postCreateCommand).
3. Start n8n to test the node:

   npx n8n start

4. Open http://localhost:5678. The Subnoto node is loaded from the workspace via N8N_CUSTOM_EXTENSIONS.
5. Add a Subnoto API credential and run a workflow with the Subnoto node.

Local (without Dev Container)

1. Install dependencies: npm install
2. Build: npm run build
3. Link for local n8n:

   mkdir -p ~/.n8n/custom && cd ~/.n8n/custom && npm init -y && npm link /path/to/n8n-node

4. Start n8n: n8n start (or npx n8n start)

Scripts

• npm run build - Build the node
• npm run build:watch - Watch and rebuild
• npm run lint - Lint
• npm run lint:fix - Lint and fix

License

MIT