OpenParable
Skip to content
← Back to skills

Documenso Install Auth

Apps & Automation
documenso-install-auth

Documenso Install Auth is an Agent Skill for apps & automation published in the Dicklesworthstone/pi_agent_rust repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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".

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Dicklesworthstone/pi_agent_rust/blob/HEAD/tests/ext_conformance/artifacts/plugins-community/plugins/saas-packs/documenso-pack/skills/documenso-install-auth/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/documenso-install-auth, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Documenso Install & Auth

Overview

Set up Documenso SDK and configure API authentication for document signing integration.

Prerequisites

  • Node.js 18+ or Python 3.10+
  • Package manager (npm, pnpm, yarn, pip, or uv)
  • Documenso account (cloud or self-hosted)
  • API key from Documenso dashboard

Instructions

Step 1: Install SDK

TypeScript/Node.js:

# npm
npm add @documenso/sdk-typescript

# pnpm
pnpm add @documenso/sdk-typescript

# yarn
yarn add @documenso/sdk-typescript

# bun
bun add @documenso/sdk-typescript

Python:

# pip
pip install documenso_sdk

# uv (recommended)
uv add documenso_sdk

# poetry
poetry add documenso_sdk

Step 2: Get API Key

  1. Log into Documenso dashboard at https://app.documenso.com
  2. Click your avatar in the top right corner
  3. Select "User settings" (or "Team settings" for team APIs)
  4. Navigate to "API tokens" tab
  5. Click "Create API Key"
  6. Copy the generated key (shown only once)

Step 3: Configure Authentication

# Set environment variable
export DOCUMENSO_API_KEY="your-api-key"

# Or create .env file
echo 'DOCUMENSO_API_KEY=your-api-key' >> .env

Step 4: Verify Connection

TypeScript:

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

const documenso = new Documenso({
  apiKey: process.env.DOCUMENSO_API_KEY ?? "",
});

// Verify connection by listing documents
async function verifyConnection() {
  try {
    const documents = await documenso.documents.findV0({});
    console.log("Connection successful!");
    console.log(`Found ${documents.documents?.length ?? 0} documents`);
    return true;
  } catch (error) {
    console.error("Connection failed:", error);
    return false;
  }
}

verifyConnection();

Python:

import os
from documenso_sdk import Documenso

documenso = Documenso(
    api_key=os.environ.get("DOCUMENSO_API_KEY")
)

# Verify connection
try:
    documents = documenso.documents.find_v0()
    print(f"Connection successful! Found {len(documents.documents)} documents")
except Exception as e:
    print(f"Connection failed: {e}")

Output

  • Installed SDK package in node_modules or site-packages
  • Environment variable or .env file with API key
  • Successful connection verification output

Error Handling

ErrorCauseSolution
Invalid API KeyIncorrect or expired keyGenerate new key in dashboard
401 UnauthorizedMissing or malformed keyCheck API key format and env var
403 ForbiddenKey lacks required permissionsUse team API key for team resources
Module Not FoundInstallation failedRun npm install or pip install again
Network ErrorFirewall blockingEnsure outbound HTTPS to api.documenso.com

API Endpoints

EnvironmentBase URL
Productionhttps://app.documenso.com/api/v2/
Staginghttps://stg-app.documenso.com/api/v2/
Self-hostedhttps://your-instance.com/api/v2/

Custom Base URL (Self-Hosted)

const documenso = new Documenso({
  apiKey: process.env.DOCUMENSO_API_KEY ?? "",
  serverURL: "https://your-documenso-instance.com/api/v2/",
});

Resources

Next Steps

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