docuseal-cli

---

Quick Start

# Run directly with npx (no install needed)
npx docuseal configure

# Or install globally
npm install -g docuseal
docuseal configure

The configure command will prompt for your API token and server:

Server [global/europe/url] (default: global): global
Enter your API token: xxxxxxxxxx
✓ Saved to ~/.config/docuseal/credentials.json

Get your API token from DocuSeal Console or DocuSeal EU Console.

Installation

npm install -g docuseal

Requirements: Node.js 18+

Usage

docuseal [COMMAND]

TOPICS
  templates    Manage templates
  submissions  Manage submissions
  submitters   Manage submitters

COMMANDS
  configure    Configure API key and server

Every command supports --help for full usage details:

docuseal submissions create --help

---

Configuration

Interactive Setup

docuseal configure

Non-Interactive Setup

docuseal configure --api-key YOUR_KEY --server global

Show Current Config

docuseal configure --list
# ✓ Current configuration
#   api_key: vS7EwXPy...kDmq
#   server: https://api.docuseal.com

Environment Variables

export DOCUSEAL_API_KEY=your_key
export DOCUSEAL_SERVER=global    # global, europe, or full URL

Config File

Stored at ~/.config/docuseal/credentials.json:

{
  "apiKey": "your_key",
  "server": "https://api.docuseal.com"
}

Priority: CLI flag > environment variable > config file.

Servers

---

Agent Skills

This CLI ships with an agent skill that teaches AI coding agents (Cursor, Claude Code, Windsurf, etc.) how to use the DocuSeal CLI effectively — including non-interactive flags, output formats, and common pitfalls.

Install skills from the central skills repository:

npx skills add docusealco/docuseal-agent-skills

For Hermes Agent:

hermes skills install docusealco/docuseal-agent-skills/skills/docuseal-cli

---

Templates

List Templates

docuseal templates list
docuseal templates list --folder Legal -l 50
docuseal templates list --archived
docuseal templates list --active

Retrieve Template

docuseal templates retrieve 1001

Create Template from PDF

docuseal templates create-pdf --file contract.pdf --name "NDA"
docuseal templates create-pdf --file form.pdf --folder-name Legal

Create Template from DOCX

docuseal templates create-docx --file template.docx --name "Contract"

Create Template from HTML

# Inline HTML
docuseal templates create-html --html "<p><text-field name=\"Name\"></text-field></p>" --name "Simple"

# From file
docuseal templates create-html --file template.html --name "Contract"

Update Template

docuseal templates update 1001 --name "NDA v2"
docuseal templates update 1001 --folder-name Contracts
docuseal templates update 1001 -d "roles[]=Signer" -d "roles[]=Reviewer"
docuseal templates update 1001 --archive
docuseal templates update 1001 --unarchive

Clone Template

docuseal templates clone 1001
docuseal templates clone 1001 --name "NDA Copy"

Merge Templates

docuseal templates merge -d "template_ids[]=1001" -d "template_ids[]=1002"
docuseal templates merge -d "template_ids[]=1001" -d "template_ids[]=1002" --name "Combined"

Update Template Documents

docuseal templates update-documents 1001 -d "documents[0][file]=https://example.com/doc.pdf" -d "documents[0][name]=New Doc"
docuseal templates update-documents 1001 --merge

Archive Template

docuseal templates archive 1001

---

Submissions

List Submissions

docuseal submissions list
docuseal submissions list --status pending
docuseal submissions list --template-id 1001 -l 50

Create Submission

Send a template for signing:

# Single submitter
docuseal submissions create \
  --template-id 1001 \
  -d "submitters[0][email][email protected]"

# Multiple submitters with roles
docuseal submissions create \
  --template-id 1001 \
  -d "submitters[0][role]=Signer" \
  -d "submitters[0][email][email protected]" \
  -d "submitters[1][role]=Witness" \
  -d "submitters[1][email][email protected]"

# With options
docuseal submissions create \
  --template-id 1001 \
  -d "submitters[0][email][email protected]" \
  --no-send-email \
  --expire-at "2025-12-31" \
  --order random

# Using JSON
docuseal submissions create \
  --template-id 1001 \
  -d '{"submitters":[{"email":"[email protected]","role":"Signer"}]}'

Create Submission from PDF

Skip template creation — send a tagged PDF directly for signing:

docuseal submissions create-pdf \
  --file document.pdf \
  -d "submitters[0][email][email protected]"

Create Submission from DOCX

docuseal submissions create-docx \
  --file document.docx \
  -d "submitters[0][email][email protected]"

Send by Email

Send a template to multiple email addresses at once:

docuseal submissions send-emails \
  --template-id 1001 \
  --emails [email protected],[email protected]

Retrieve Submission

docuseal submissions retrieve 502

Get Submission Documents

docuseal submissions documents 502
docuseal submissions documents 502 --merge

Archive Submission

docuseal submissions archive 502

---

Submitters

List Submitters

docuseal submitters list
docuseal submitters list --submission-id 502

Retrieve Submitter

docuseal submitters retrieve 201

Update Submitter

# Change email
docuseal submitters update 201 --email [email protected]

# Mark as completed (auto-sign via API)
docuseal submitters update 201 --completed

# Re-send signature request
docuseal submitters update 201 --send-email

# Pre-fill fields and metadata
docuseal submitters update 201 -d "values[First Name]=John" -d "metadata[department]=Sales"

---

Global Flags

These flags work on every command:

Flags available on list commands:

Flag available on commands with body parameters:

Override Server Per-Command