Esign automation

eSign Automation

This skill provides automation capabilities for the eSignGlobal electronic signature platform. It enables AI agents to automate document signing workflows and integrate with eSignGlobal APIs.

Best For

Use this skill when the user wants to:

• send a contract, agreement, or approval form for signature
• launch a new e-sign workflow from a local file
• send one document to one or more recipients for signing

Example requests:

• "Send this contract to John for signature"
• "Start a signing workflow for this PDF"
• "Send this agreement to Alice and Bob"

What This Skill Does

The skill runs the following steps:

1. Authenticate with eSignGlobal using ESIGNGLOBAL_APIKEY
2. Request a secure upload URL
3. Upload the source document
4. Create and start the envelope

Requirements

• Node.js 18 or later
• A TypeScript runner:
  • recommended: npx tsx
  • optional: npx ts-node
• An eSignGlobal application key exposed as ESIGNGLOBAL_APIKEY

Required Configuration

Set the environment variable below before running the skill:

• ESIGNGLOBAL_APIKEY

If the user does not already have an app key, direct them to:

1. Sign in at https://www.esignglobal.com
2. Open Settings -> Integration -> Apps
3. Create an application and copy the generated API Key

Required Inputs

To send an envelope, collect:

• filePath: absolute path to the local file
• signers: JSON array of signer objects

Optional input:

• subject: custom email or envelope subject; when omitted, the document name without its extension is used first

Input Format

filePath

filePath must be an absolute path to an existing local file.

Example:

/tmp/contract.pdf

signers

Each signer must include:

• userName
• userEmail

Optional field:

• signOrder (integer, minimum 1)

Single signer example:

[
  {
    "userName": "Bob Smith",
    "userEmail": "[email protected]"
  }
]

Sequential signing example:

[
  {
    "userName": "Bob Smith",
    "userEmail": "[email protected]",
    "signOrder": 1
  },
  {
    "userName": "Alice Jones",
    "userEmail": "[email protected]",
    "signOrder": 2
  }
]

Parallel signing example:

[
  {
    "userName": "Bob Smith",
    "userEmail": "[email protected]",
    "signOrder": 1
  },
  {
    "userName": "Alice Jones",
    "userEmail": "[email protected]",
    "signOrder": 1
  }
]

Command

npx tsx scripts/send_envelope.ts send <filePath> <signersJson> [subject]

Example:

npx tsx scripts/send_envelope.ts send "/tmp/contract.pdf" '[{"userName":"Bob","userEmail":"[email protected]"}]'

Output

The script returns JSON.

Success example:

{
  "success": true,
  "step": "send",
  "message": "Envelope initiated successfully"
}

Failure example:

{
  "success": false,
  "step": "send",
  "message": "Failed to execute envelope flow",
  "error": "Authentication failed"
}

Security Notes

• Provide credentials only through ESIGNGLOBAL_APIKEY
• Never print, log, or persist secrets in files
• Only use trusted local files as input