eSignature Integration
Overview
The E-Signature module integrates electronic signature capabilities into FormKiQ through the DocuSign API. It is a separately licensed add-on for Advanced and Enterprise and uses your DocuSign license, account configuration, and provider terms. Other providers, including Adobe Acrobat Sign, require a separately scoped integration.
FormKiQ built-in eSignature is in development, targeting early 2027. The currently available signing workflow described here uses DocuSign. See editions and licensing.
Sending documents for signing makes the relevant content and recipient information available to the provider. Review provider processing locations, retention, credentials, callback handling, and signed-output storage alongside your FormKiQ deployment.
Features & Benefits
Core Features
- Electronic signature integration for documents
- Support for PDF and MS Office formats
- Secure signature workflows
- Customizable notifications
- Status tracking
Key Benefits
- Simplified Process: Streamlined signature collection
- Security: DocuSign's secure signature platform
- Flexibility: Remote and in-person signing
- Integration: Seamless FormKiQ platform integration
- Notifications: Customizable reminders and expiration settings
Use Cases
Business Operations
- Contract Management
- Purchase Order Approvals
- Proposal Signatures
- Document Approvals
Human Resources
- Employment Agreements
- Onboarding Documents
- Policy Acknowledgments
- Benefits Enrollment
Real Estate
- Property Contracts
- Lease Agreements
- Disclosure Forms
- Purchase Agreements
Healthcare
- Patient Consent Forms
- Medical Records
- HIPAA Documents
- Treatment Authorizations
Setup Guide
1. DocuSign Configuration
Create Developer Account
- Visit DocuSign Developer Center
- Create and activate account
Generate Integration Key
- Navigate to Settings → Integrations → Apps and Keys
- Click "Add App & Integration Key"
- Save app name to receive Integration Key
Create RSA Keypair
- Locate RSA Keypairs section
- Click "Add RSA Keypair"
- Download private key immediately
- Store key securely
Obtain User ID
- Access DocuSign Profile
- Locate User ID in API and Keys section
2. FormKiQ Configuration
Configure DocuSign integration using the FormKiQ API:
PATCH /sites/{siteId}/configuration
{
"docusign": {
"userId": "your-docuSign-userId",
"integrationKey": "your-docuSign-integrationKey",
"rsaPrivateKey": "your-docuSign-rsaPrivateKey"
}
}
API Reference
Create Envelope
POST /esignature/docusign/{documentId}/envelopes
Initiates signature process by creating DocuSign envelope
Create Recipient View
POST /esignature/docusign/{documentId}/envelopes/{envelopeId}/views/recipient
Generates recipient-specific signing URL
Inspect envelope activity
In v1.19.2, the integration can retrieve provider activity for an associated document or artifact:
GET /esignature/docusign/{documentId}/envelopes/{envelopeId}/auditEvents
This returns provider-recorded activity and requires access to the document or artifact and its stored envelope association. It does not prove inbox delivery, perform cryptographic signature validation, or automatically preserve a permanent evidence snapshot. Configure evidence storage and retention where required.
Handle Events
POST /esignature/docusign/events
Processes DocuSign callback events
For complete API documentation, see E-Signature API Reference.
Best Practices
-
Security
- Secure storage of integration keys
- Regular key rotation
- Monitor signature events
-
Implementation
- Test workflows thoroughly
- Implement error handling
- Monitor signature status
-
User Experience
- Clear signing instructions
- Appropriate reminders
- Status notifications