Skip to main content

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​

  1. Visit DocuSign Developer Center
  2. Create and activate account

Generate Integration Key​

  1. Navigate to Settings → Integrations → Apps and Keys
  2. Click "Add App & Integration Key"
  3. Save app name to receive Integration Key

Create RSA Keypair​

  1. Locate RSA Keypairs section
  2. Click "Add RSA Keypair"
  3. Download private key immediately
  4. Store key securely

Obtain User ID​

  1. Access DocuSign Profile
  2. 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​

  1. Security

    • Secure storage of integration keys
    • Regular key rotation
    • Monitor signature events
  2. Implementation

    • Test workflows thoroughly
    • Implement error handling
    • Monitor signature status
  3. User Experience

    • Clear signing instructions
    • Appropriate reminders
    • Status notifications