Aller au contenu
Subnoto Logo Subnoto Documentation

Integrate with n8n

Ce contenu n’est pas encore disponible dans votre langue.

n8n is a workflow automation platform. The Subnoto community node lets you integrate Subnoto electronic signing into your n8n workflows: upload documents, add recipients, place signature blocks, and send envelopes without writing code.

The node is open source: n8n-nodes-subnoto on GitHub.

Prerequisites

  • Self-hosted n8n: The Subnoto node is a community node and is only available on self-hosted n8n, not on n8n Cloud.
  • Subnoto credentials: API base URL, access key, and secret key from your Subnoto account.

Installation

  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:

    Terminal window
    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 before starting n8n:

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

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

  3. Restart n8n, then add a Subnoto API credential and use the Subnoto node in your workflows.

Credentials

Create a Subnoto API credential in n8n with:

FieldDescription
API Base URLYour Subnoto API base URL (e.g. https://enclave.subnoto.com)
Access KeyYour API access key
Secret KeyYour API secret key
Unattested ModeOptional (default: false)

Operations

The Subnoto node supports these 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.

Example workflow: sending a document for signature

A typical flow is: trigger → list workspaces → filter (e.g. select a workspace) → read file from disk → upload document → add recipients → add signature blocks → send envelope.

Example n8n workflow sending a document for signature with Subnoto

Steps in the example:

  1. When clicking “Execute workflow” — Manual trigger to run the workflow.
  2. List workspaces — Subnoto node: list workspaces to get workspace IDs.
  3. Filter — Keep the workspace (or item) you need for the rest of the flow.
  4. Read/Write Files from Disk — Read the PDF or Word file you want to send for signature.
  5. Upload a document — Subnoto node: upload the file and create an envelope.
  6. Add recipients — Subnoto node: add signers to the envelope.
  7. Add signature blocks — Subnoto node: place signature blocks on the document.
  8. Send envelope — Subnoto node: send the envelope to recipients.

After the workflow runs, recipients receive an email and can sign the document in Subnoto.

Development

To develop or test the node locally:

  1. Clone the repo: github.com/subnoto/n8n-nodes-subnoto.
  2. Install dependencies: npm install
  3. Build: npm run build
  4. For local n8n: link the package into n8n’s custom nodes directory and set N8N_CUSTOM_EXTENSIONS to that path, then start n8n.

The repository includes a Dev Container; open it in VS Code or Cursor and use Reopen in Container to get a preconfigured environment with n8n and the Subnoto node loaded from the workspace.