Index of every page on this site: llms.txt
All skills
jeremylongshore avatar

/documenso-install-auth

@820dfc8
Run it yourself

Install and configure Documenso SDK/API authentication. Use when setting up a new Documenso integration, configuring API keys, or initializing Documenso in your project. Trigger with phrases like "install documenso", "setup documenso", "documenso auth", "configure documenso API key".

Use this Skill: https://skilld.dev/gh/jeremylongshore/tons-of-skills-marketplace/documenso-install-auth

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈77 tokens for metadata: the name and description. ≈1.3k when used: this file. ≈909 more on demand in 1 file.

Description uses 3.9% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈309 characters, or 3.9%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Documenso Install & Auth

Output

  • A scoped Documenso credential/reference for the intended environment, with a verified low-impact authorization check.
  • A secret-ownership and revocation path that keeps tokens and signing material out of repositories and logs.

Examples

Inject a development credential from the approved secret manager, create or read a synthetic document through a least-privilege role, and record only environment/result. If a key or signing URL is exposed, revoke it first and reissue after investigation; do not reuse it while attempting cleanup.

Overview

Set up the Documenso SDK and configure API authentication for document signing. Covers the TypeScript SDK (@documenso/sdk-typescript), the Python SDK (documenso-sdk-python), and raw REST API usage. Documenso exposes two API versions: v1 (legacy, documents only) and v2 (envelopes, multi-document, recommended for new work).

Prerequisites

  • Node.js 18+ or Python 3.10+
  • Package manager (npm, pnpm, yarn, pip, or uv)
  • Documenso account — cloud at app.documenso.com or self-hosted instance
  • API key generated from the Documenso dashboard

Instructions

Step 1: Install the SDK

TypeScript / Node.js:

npm install @documenso/sdk-typescript
# or
pnpm add @documenso/sdk-typescript

Python:

pip install documenso-sdk-python
# or
uv pip install documenso-sdk-python

Step 2: Generate an API Key

  1. Log in to your Documenso dashboard (https://app.documenso.com or your self-hosted URL).
  2. Click your avatar (top-right) and select User settings (or Team settings for team-scoped keys).
  3. Navigate to the API tokens tab.
  4. Click Create API Key, give it a descriptive name (e.g. ci-pipeline-prod).
  5. Copy the key immediately — it is shown only once.

Team API keys inherit the team's document and template access. Personal keys only access your own documents.

Step 3: Store the Key Securely

# .env (never commit this file)
DOCUMENSO_API_KEY=api_xxxxxxxxxxxxxxxxxxxxxxxxxx

Add .env to .gitignore:

echo ".env" >> .gitignore

Step 4: Initialize the Client

TypeScript — v2 API (recommended):

import { Documenso } from "@documenso/sdk-typescript";

const documenso = new Documenso({
  apiKey: process.env.DOCUMENSO_API_KEY!,
  // For self-hosted, override the server URL:
  // serverURL: "https://sign.yourcompany.com/api/v2",
});

TypeScript — v1 REST (legacy):

const BASE = process.env.DOCUMENSO_BASE_URL ?? "https://app.documenso.com/api/v1";
const headers = { Authorization: `Bearer ${process.env.DOCUMENSO_API_KEY}` };

const res = await fetch(`${BASE}/documents`, { headers });
const docs = await res.json();

Python:

from documenso_sdk_python import Documenso
import os

client = Documenso(api_key=os.environ["DOCUMENSO_API_KEY"])

Step 5: Verify the Connection

// verify-connection.ts
import { Documenso } from "@documenso/sdk-typescript";

async function verify() {
  const client = new Documenso({ apiKey: process.env.DOCUMENSO_API_KEY! });
  const { documents } = await client.documents.findV0({ page: 1, perPage: 1 });
  console.log(`Connected — ${documents.length >= 0 ? "OK" : "FAIL"}`);
}
verify().catch(console.error);

Run with npx tsx verify-connection.ts.

API Endpoints

Environment Base URL (v2) Base URL (v1, legacy)
Cloud production https://app.documenso.com/api/v2 https://app.documenso.com/api/v1
Cloud staging https://stg-app.documenso.com/api/v2 https://stg-app.documenso.com/api/v1
Self-hosted https://your-instance.com/api/v2 https://your-instance.com/api/v1

Self-Hosted Base URL Override

const documenso = new Documenso({
  apiKey: process.env.DOCUMENSO_API_KEY!,
  serverURL: process.env.DOCUMENSO_BASE_URL, // e.g. "https://sign.acme.com/api/v2"
});

Error Handling

Error HTTP Cause Solution
Unauthorized 401 Invalid or expired API key Regenerate key in dashboard
Forbidden 403 Personal key accessing team resources Use team-scoped API key
Module not found N/A SDK not installed Run npm install @documenso/sdk-typescript
Network error N/A Firewall or DNS issue Verify outbound HTTPS to app.documenso.com
ERR_INVALID_URL N/A Bad serverURL value Include protocol and path: https://host/api/v2

Security Checklist

  • API key stored in environment variable, never in source code
  • .env is listed in .gitignore
  • CI secrets use masked/encrypted storage (GitHub Secrets, Vault, etc.)
  • Team keys rotated on employee offboarding
  • Self-hosted instances use HTTPS with valid TLS certificates

Resources

Next Steps

After successful auth, proceed to documenso-hello-world for your first document.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill provides standard instructions for installing and configuring the Documenso SDK. It utilizes official packages from public registries and follows security best practices for secret management by using environment variables and ensuring sensitive files are excluded from version control.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

Signed by skilld at 820dfc8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 20 hours ago.

Activeupdated 3 months ago
What it can do
Reads files Edits files Runs commands
version
1.14.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
[
  "saas",
  "documenso",
  "api",
  "authentication"
]
All 7 allowed tools
ReadWriteEditBash(npm:*)Bash(pip:*)Bash(pnpm:*)Grep
Other metadata
compatibility
Designed for Claude Code

README badge

README badge for jeremylongshore/tons-of-skills-marketplace/documenso-install-auth