n8n community node for Documenso — the open source document signing platform.
Automate document signing workflows directly from n8n using the Documenso API v2.
You need a Documenso API key.
- Log in at app.documenso.com (or your self-hosted instance)
- Go to Settings → API Tokens
- Click Create Token and copy the key
In your n8n instance, go to Settings → Community Nodes and install:
@documenso/n8n-nodes-documenso
| Field | Description |
|---|---|
| API Key | Your Documenso API token |
| Base URL | https://app.documenso.com/api/v2 (default). Change for self-hosted instances. |
The main node with 7 resources and 35 operations.
| Operation | Description |
|---|---|
| Find | Search for documents |
| Get | Get a document by ID |
| Create | Upload a PDF and create a new document |
| Create and Send | Upload a PDF, add recipients and fields, and send for signing — all in one step |
| Update | Update document metadata |
| Delete | Delete a document |
| Duplicate | Duplicate a document |
| Download | Download the signed PDF |
| Send | Send a document to recipients for signing |
| Resend | Resend to specific recipients |
| Operation | Description |
|---|---|
| Find | Search for templates |
| Get | Get a template by ID |
| Create | Upload a PDF and create a new template |
| Update | Update template metadata |
| Delete | Delete a template |
| Duplicate | Duplicate a template |
| Use | Create a document from a template, optionally sending it immediately |
| Operation | Description |
|---|---|
| Create | Add recipients to a document or template |
| Get | Get a recipient by ID |
| Update | Update recipients |
| Delete | Remove a recipient |
| Operation | Description |
|---|---|
| Create | Add fields using placeholder text matching ({{signature}}), coordinates, or JSON |
| Get | Get a field by ID |
| Update | Update fields |
| Delete | Remove a field |
| Operation | Description |
|---|---|
| Upload | Upload files to a document or template |
| Download | Download a file |
| Update | Update file metadata |
| Delete | Remove a file |
| Operation | Description |
|---|---|
| Find | List attachments on a document or template |
| Create | Add a URL attachment |
| Update | Update an attachment |
| Delete | Remove an attachment |
| Operation | Description |
|---|---|
| Find | Search for folders |
| Create | Create a folder |
| Update | Update a folder |
| Delete | Delete a folder |
Webhook-based trigger node that starts a workflow when a Documenso event occurs.
| Event | Description |
|---|---|
| Document Created | A new document was created |
| Document Sent | A document was sent to recipients |
| Document Opened | A recipient opened the document |
| Document Signed | A recipient signed the document |
| Document Completed | All recipients have signed |
| Document Rejected | A recipient rejected the document |
| Document Cancelled | The sender cancelled the document |
Webhooks must be configured manually in Documenso (Team Settings → Webhooks). Optional secret verification via the X-Documenso-Secret header.
Send a document for signing (one node):
- Documenso (Document: Create and Send) — upload PDF, add recipients with signing fields, sends immediately
Send a document step-by-step:
- Documenso (Document: Create) — upload a PDF
- Documenso (Recipient: Create) — add signers
- Documenso (Field: Create) — add signature fields via placeholder text matching
- Documenso (Document: Send) — send for signing
Use a template:
- Documenso (Template: Use) — create document from template with recipient overrides, optionally send immediately
React to signing events:
- Documenso Trigger (Document Completed) — triggers when all recipients have signed
- Documenso (Document: Download) — download the signed PDF
Change the Base URL in credentials to your instance:
https://your-domain.com/api/v2
bun install # install dependencies
bun run build # build with tsdown
bun run typecheck # type-check
bun run check # lint + format (biome)
bun run dev # run n8n locally with docker composeAfter changes: bun run build && docker compose restart
MIT