Docuseal

Agent Protocol

Rules for agents:

• Supply ALL required flags — the CLI will not prompt for missing parameters.
• Output is always JSON.
• Use -d key=value (bracket notation) or -d '{"..": ".."}' (JSON) for body and array parameters.

Authentication

Set environment variables:

• DOCUSEAL_API_KEY — API key (required). Get yours at https://console.docuseal.com/api
• DOCUSEAL_SERVER — global (default), europe, or full URL for self-hosted (e.g. https://docuseal.yourdomain.com)

Available Commands

Read the matching reference file for detailed flags and examples.

Common Mistakes

Common Patterns

List templates:

docuseal templates list --q "NDA" --limit 20

Create a template from a PDF and send for signing:

docuseal templates create-pdf --file contract.pdf --name "NDA"
docuseal submissions send-emails --template-id 1001 --emails [email protected]

Create a submission with pre-filled fields (bracket notation):

docuseal submissions create --template-id 1001 \
  -d "submitters[0][email][email protected]" \
  -d "submitters[0][values][Company Name]=Acme Corp"

Create a submission with pre-filled fields (JSON):

docuseal submissions create --template-id 1001 \
  -d '{"submitters": [{"email": "[email protected]", "values": {"Company Name": "Acme Corp"}}]}'

Check signing status:

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

Update a submitter:

docuseal submitters update 201 --email [email protected] --send-email

When to Load References

• Creating or managing templates → references/templates.md
• Sending documents for signing or tracking status → references/submissions.md
• Using dynamic content variables in DOCX → references/docx-variables.md
• Embedding field tags in PDF/DOCX → references/field-tags.md
• Writing HTML templates with field tags → references/html-fields.md
• Listing or updating signers → references/submitters.md