SmartDocs API

Integrations

Connect SmartDocs to the tools you already use. Today we ship an official n8n community node, so you can automate document signing without writing a line of code.

n8n

n8n is a workflow-automation platform. The official n8n-nodes-smartdocs community node wraps this API, so you can build flows like "a deal closes in your CRM → send the contract for signature → store the signed PDF when it's done" — visually, no code.

Install

In a self-hosted n8n instance, open Settings → Community Nodes → Install and enter the package name:

n8n-nodes-smartdocs

The package is published on npm: npmjs.com/package/n8n-nodes-smartdocs.

Authenticate

Create the SmartDocs API credential in n8n and paste an organization API key (sdk_live_…) — the same key described in Authentication. All requests go to https://api.smartdocs.de/api/v1.

What you can do

  • Action node — work with signing processes, templates, PDF and template assets, categories and tags, and webhooks: start signing from a template, create ad-hoc signing processes, download the signed PDF and completion certificate, and more.
  • Trigger node — start a workflow in real time when a signing event fires (signing.completed, signer.completed, signing.declined, and others). It registers a webhook with SmartDocs automatically and verifies the signature of every delivery.

The trigger relies on outbound webhooks, which require a plan that includes the webhooks feature.

Example: download the signed PDF on completion

  1. Add a SmartDocs Trigger node and subscribe to Signing Completed.
  2. Add a SmartDocs action node → Signing Process → Get Files, with Signing Process ID set from {{ $json.data.signingProcess.id }}.
  3. Enable Download Files to receive the signed PDF and completion certificate as binary data.
  4. Pipe it to a Write Binary File, cloud-storage, or Send Email node.

New here? Start with the Quickstart to create your API key, or browse the API reference for the endpoints the node calls under the hood.