n8n-nodes-docusign-esign


An n8n community node for DocuSign - the world's leading eSignature platform for sending documents for signature and managing envelopes.

Features

- Full Envelope Management - Create, send, void, delete, and download documents
- Embedded Signing - Generate signing URLs for iframe integration in your app
- Multiple Signers & Documents - Support for multiple signers with routing order and multiple documents per envelope
- Merge Fields - Populate document placeholders like {{FirstName}} with dynamic values
- Advanced Tab Types - Signature, initials, date, text, checkboxes, radio groups, dropdowns, numbers, formulas, signer attachments
- Reminders & Expiration - Automatic reminder emails and envelope expiration deadlines
- Recipient Authentication - Access code, phone, or SMS verification before signing
- Envelope Correction - Fix sent envelopes without voiding via correction URL
- Custom Fields - Add metadata fields to envelopes for tracking and reporting
- Template CRUD - Create, get, update, and delete templates with documents and roles
- Bulk Send - Send envelopes to 100+ recipients via bulk send lists
- PowerForms - Create self-service signing links from templates
- Folder Management - List folders, get items, move envelopes, and search across system folders
- Webhook Trigger - Real-time event notifications via DocuSign Connect
- Regional Support - NA, EU, AU, and CA regions for production environments
- Rate Limiting - Built-in retry logic with exponential backoff
- Input Validation - RFC 5322 compliant email validation, secure URL validation (blocks internal networks)
- Token Caching - Efficient JWT token caching with automatic refresh
- Type Safety - Full TypeScript support with comprehensive type definitions
- Security Hardened - HMAC-SHA256 webhook signature verification, replay attack protection

Requirements

$3

| Environment | Plan Required |
|-------------|---------------|
| Development/Testing | Free Developer Account |
| Production | Business Pro or higher |
| Webhooks (DocuSign Connect) | Business Pro+ or Connect add-on |

Start with a free DocuSign Developer Account to test before committing to a paid plan.

Installation

$3

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter n8n-nodes-docusign-esign
4. Click Install

$3

``bash
npm install n8n-nodes-docusign-esign
`

Credentials

To use this node, you need DocuSign API credentials:

1. Log in to your DocuSign Admin
2. Go to Settings > Apps and Keys
3. Create an Integration Key (Client ID)
4. Generate an RSA Key Pair and save the private key
5. Note your User ID and Account ID

$3

Before first use, grant consent for your integration:

Demo:
`
https://account-d.docusign.com/oauth/auth?response_type=code&scope=signature%20impersonation&client_id=YOUR_INTEGRATION_KEY&redirect_uri=YOUR_REDIRECT_URI
`

Production:
`
https://account.docusign.com/oauth/auth?response_type=code&scope=signature%20impersonation&client_id=YOUR_INTEGRATION_KEY&redirect_uri=YOUR_REDIRECT_URI
`

Nodes

$3

The main node for interacting with the DocuSign eSignature API.

#### Resources & Operations

| Resource | Operations |
|----------|------------|
| Envelope | Create, Create From Template, Get, Get Many, Send, Resend, Void, Delete, Download Document, List Documents, Get Recipients, Update Recipients, Get Audit Events, Create Signing URL, Correct |
| Template | Create, Get, Get Many, Update, Delete |
| Bulk Send | Create List, Get List, Get Many Lists, Delete List, Send, Get Batch Status |
| PowerForm | Create, Get, Get Many, Delete |
| Folder | Get Many, Get Items, Move Envelope, Search |

#### Envelope Create Options

| Option | Description |
|--------|-------------|
| Multiple Signers | Add additional signers with routing order |
| Multiple Documents | Attach multiple documents to one envelope |
| Embedded Signing | Enable for iframe integration (adds clientUserId) |
| Merge Fields | Populate placeholders like {{FirstName}} with dynamic values |
| Custom Fields | Add metadata fields for tracking |
| Additional Tabs | Initial, date, text, checkbox, company, title, radio group, dropdown, number, formula, signer attachment |
| Anchor Tags | Position signature fields using text anchors |
| Reminders | Automatic reminder emails with configurable delay and frequency |
| Expiration | Set envelope expiration with warning period |
| Signer Authentication | Access code, phone, or SMS verification before signing |
| Allow Markup | Let signers add comments and annotations |
| Allow Reassign | Let signers reassign to another person |
| Brand ID | Use custom branding for the envelope |
| Enable Wet Sign | Allow print-and-sign option |
| Enforce Signer Visibility | Signers only see their own fields |

$3

Webhook trigger node for receiving real-time events via DocuSign Connect.

#### Supported Events

- envelope-sent - Envelope sent to recipients
- envelope-delivered - Envelope delivered to recipient
- envelope-completed - All recipients completed signing
- envelope-declined - Recipient declined to sign
- envelope-voided - Envelope voided
- recipient-sent - Recipient received envelope
- recipient-delivered - Recipient viewed envelope
- recipient-completed - Recipient completed signing
- recipient-declined - Recipient declined
- recipient-authenticationfailed - Recipient failed authentication
- template-created - Template created
- template-modified - Template modified
- template-deleted - Template deleted

Example Workflows

$3

`
HTTP Request (Get Contract) > DocuSign (Create Envelope) > Slack (Notify Team)
`

Send a document for signature and notify your team.

$3

`
DocuSign Trigger (envelope-completed) > DocuSign (Download Document) > Google Drive (Upload)
`

Automatically save signed documents to cloud storage.

$3

`
Form Trigger > DocuSign (Create Envelope with Multiple Signers) > Wait for Completion
`

Create envelopes with multiple signers using routing order.

$3

`
New Employee (Webhook) > DocuSign (Create From Template) > HR System (Update)
`

Use templates for standardized documents like onboarding forms.

$3

`
Form Trigger > DocuSign (Create Envelope, Embedded=true) > DocuSign (Create Signing URL) > Redirect User
`

Generate signing URLs for embedding DocuSign in your application.

$3

`
Form Trigger > DocuSign (Create Envelope with Merge Fields) > Notify User
`

Populate document placeholders like {{FirstName}}, {{Company}}, {{Date}} with form data. Put placeholders in your PDF, then map them in the Merge Fields section.

$3

`
Schedule Trigger > DocuSign (Get Many, status=sent) > Google Sheets (Update)
`

Track pending envelopes and update a dashboard.

$3

Copy and import this JSON into n8n via Workflows > Import from URL/File:

`json
{
"name": "Send Document for Signature",
"nodes": [
{
"parameters": {},
"name": "Start",
"type": "n8n-nodes-base.manualTrigger",
"typeVersion": 1,
"position": [240, 300]
},
{
"parameters": {
"resource": "envelope",
"operation": "create",
"emailSubject": "Please sign this document",
"signerEmail": "={{$json.signerEmail}}",
"signerName": "={{$json.signerName}}",
"document": "={{$json.documentBase64}}",
"documentName": "contract.pdf",
"sendImmediately": true
},
"name": "DocuSign",
"type": "n8n-nodes-docusign-esign.docuSign",
"typeVersion": 1,
"position": [460, 300],
"credentials": {
"docuSignApi": {
"id": "1",
"name": "DocuSign API"
}
}
}
],
"connections": {
"Start": {
"main": [[{ "node": "DocuSign", "type": "main", "index": 0 }]]
}
}
}
`

$3

`json
{
"name": "Auto-Save Signed Documents",
"nodes": [
{
"parameters": {
"events": ["envelope-completed"],
"verifySignature": true,
"replayProtection": true
},
"name": "DocuSign Trigger",
"type": "n8n-nodes-docusign-esign.docuSignTrigger",
"typeVersion": 1,
"position": [240, 300],
"webhookId": "docusign-webhook",
"credentials": {
"docuSignApi": {
"id": "1",
"name": "DocuSign API"
}
}
},
{
"parameters": {
"resource": "envelope",
"operation": "downloadDocument",
"envelopeId": "={{$json.envelopeId}}",
"documentId": "combined",
"binaryPropertyName": "data"
},
"name": "Download Document",
"type": "n8n-nodes-docusign-esign.docuSign",
"typeVersion": 1,
"position": [460, 300],
"credentials": {
"docuSignApi": {
"id": "1",
"name": "DocuSign API"
}
}
}
],
"connections": {
"DocuSign Trigger": {
"main": [[{ "node": "Download Document", "type": "main", "index": 0 }]]
}
}
}
`

Filtering

"Get Many" operations support filtering:

| Filter | Description | Available On |
|--------|-------------|--------------|
| status | Filter by envelope status | Envelopes, Folder Search |
| fromDate | Start date for date range | Envelopes, Folder Search |
| toDate | End date for date range | Envelopes, Folder Search |
| searchText | Search by subject or recipient | Envelopes, Templates, Folder Search |
| folderId | Filter by folder | Templates |

Security

$3

The webhook trigger includes built-in security features:

- HMAC-SHA256 Signature Verification - All webhooks verified using signatures
- Replay Attack Protection - Rejects webhook requests older than 5 minutes
- Timing-Safe Comparison - Prevents timing attacks
- Configurable Verification - Enable/disable signature and replay protection in trigger settings

$3

- Email Validation - RFC 5322 compliant validation
- UUID Validation - Format validation for envelope/template IDs
- Base64 Validation - Document content validation
- URL Validation - Blocks internal/private network URLs to prevent SSRF attacks:
- localhost, 127.0.0.1, 0.0.0.0
- Private ranges: 10.x.x.x, 172.16-31.x.x, 192.168.x.x
- Link-local: 169.254.x.x (AWS metadata endpoint)

$3

- JWT tokens cached in memory only (never persisted)
- Automatic refresh 5 minutes before expiration
- RSA keys handled securely via n8n credentials

Error Handling

The node includes built-in error handling with detailed messages:

- Continue on Fail: Enable to process remaining items even if some fail
- Detailed Errors: Field-level error details for validation failures
- Automatic Retry: Rate limit and server errors automatically retried

$3

| Status Code | Description |
|-------------|-------------|
| 400 | Bad Request - Invalid or malformed request |
| 401 | Unauthorized - Invalid credentials or expired token |
| 403 | Forbidden - No permission to access resource |
| 404 | Not Found - Envelope or template does not exist |
| 429 | Rate Limited - Too many requests (auto-retry) |
| 500+ | Server Error - DocuSign server issue (auto-retry) |

Troubleshooting

$3

1. Visit the consent URL for your environment (demo or production)
2. Log in with the user account specified in credentials
3. Grant access to the integration

$3

1. Verify your RSA private key is complete (including BEGIN/END lines)
2. Check Integration Key (Client ID) is correct
3. Ensure User ID matches the account granting consent

$3

1. Verify the webhook URL is publicly accessible
2. Check DocuSign Connect configuration matches n8n URL
3. Verify HMAC secret matches (if using signature verification)
4. Check event types are enabled in Connect settings

$3

If you encounter rate limiting (429 errors):

1. The node automatically retries with backoff
2. Reduce frequency of API calls
3. Use "Return All" sparingly for large datasets
4. Consider caching responses where appropriate

Development

`bash


Install dependencies

npm install

Build the node

npm run build

Watch mode (rebuild on changes)

npm run dev

Run tests

npm test

Run tests with coverage

npm run test:coverage

Run linter

npm run lint

Fix linting issues

npm run lintfix

Check formatting

npm run format:check

Format code

npm run format

Type check

npm run typecheck
`

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Resources

- DocuSign Developer Center
- eSignature REST API Reference
- JWT Authentication Guide
- DocuSign Connect Guide
- n8n Community Nodes Documentation

Changelog

$3

Power Features:
- Bulk Send - Create recipient lists, send to 100+ recipients, monitor batch status
- Template CRUD - Full template lifecycle: create with documents, update metadata, delete
- PowerForms - Self-service signing links with configurable email, mobile, and usage limits
- Folder Management - List folders, browse items, move envelopes, search with text/date/status filters
- Test coverage to 95.6% (267 tests), DocuSign.node.ts at 99.67%

$3

New Features:
- Envelope reminders & expiration - automatic reminder emails and expiration deadlines
- Recipient authentication - access code, phone, and SMS verification options
- 5 new tab types: radio group, dropdown/list, number, formula, signer attachment
- Envelope correction - generate correction URLs to fix sent envelopes without voiding
- Test coverage to 93.62% (190 tests), DocuSign.node.ts at 98.45%

$3

Quality & Verification:
- Test coverage to 92.91% (171 tests), DocuSign.node.ts at 97.79%
- n8n linter compliance (fixed restricted setTimeout global)
- Removed deprecated validateRequired/validateEmail functions
- Added importable JSON workflow examples to README

$3

Maintenance:
- Renamed package to n8n-nodes-docusign-esign for n8n Community Nodes compatibility
- Improved test coverage (140 tests)

$3

New Features:
- Additional Envelope Options - More control over envelope behavior:
- Allow Markup - Let signers annotate documents
- Allow Reassign - Let signers reassign to others
- Brand ID - Use custom branding
- Enable Wet Sign - Allow print-and-sign
- Enforce Signer Visibility - Signers only see their fields

$3

New Features:
- Merge Fields - Simple UI for populating document placeholders with dynamic values
- Add placeholder/value pairs like {{FirstName}} → John`
- Configurable font size (Size 7-72)
- Automatically converts to anchored text tabs

$3

New Features:
- Embedded signing URL generation (Create Signing URL operation)
- List Documents operation
- Custom fields support for envelope metadata
- Additional tab types: Initial, Date Signed, Text, Checkbox, Full Name, Email, Company, Title
- Embedded signing option in Create Envelope (adds clientUserId)
- Requirements section with DocuSign plan information

$3

New Features:
- Replay attack protection for webhooks (rejects requests older than 5 minutes)
- Delete operation for draft envelopes
- CI/CD pipeline with GitHub Actions
- Mocked webhook handler tests for 100% trigger coverage

$3

Initial Release:
- Full envelope management (create, send, void, download, recipients, audit)
- Template operations (get, list)
- Multiple signers and documents support
- DocuSign Trigger for real-time webhook events
- Regional support (NA, EU, AU, CA)
- JWT authentication with token caching
- Rate limiting with automatic retry
- Input validation (email, UUID, base64, URL with SSRF protection)
- HMAC-SHA256 webhook signature verification
- 61 tests with comprehensive coverage

License

MIT

---

Made with ✍️ by Jan Marc Coloma