Docustay developer documentation

Docustay sends documents for signature. Everything you can do in the app you can also do from code, within the permissions of an API key you create.

You want to	Start here
Send your first document in ten minutes	Quickstart
Understand keys, scopes and test keys	Authentication
Make a document from words and people, answer a template's questions, collect a payment	Documents from words and people
Turn HTML or a tagged PDF into a template	Templates and text tags
Show the signing form inside your own app	Embedded signing
Get told when a document is signed	Webhooks
Practise without sending anything real	Test mode
Handle failures and limits	Errors, retries and limits
Use a ready-made client	SDKs
Let an AI assistant do it	MCP server and agent skills
Look up an operation	API reference

Every page here is also served as plain Markdown at the same address with .md on the end, and /llms.txt lists them all for tools that read documentation.

What you can build

A typical integration is small. Your system decides a document is needed, calls the API with a template and the people's names and emails, and waits for a webhook. When the webhook says the document is completed, your system downloads the signed copy and files it. Everything between is Docustay's job: emailing, reminders, the signing page, the certificate and the seal.

curl -X POST https://docustay.app/api/v1/documents/send \
  -H "Authorization: Bearer $DOCUSTAY_KEY" -H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" \
  -d '{ "templateId": "TEMPLATE_ID", "parties": [{ "seat": "signer_1", "name": "Rosa Alvarez", "email": "rosa@example.com" }] }'

Where to start

New to it: do the quickstart with a test key, which emails only you. Already sending: read Webhooks and Errors, retries and limits before you go live, because retries and repeat deliveries are where integrations go wrong. Building a product: read Embedded signing.

What is included

The API, webhooks and embedding are in every plan, within your monthly allowance. Test mode is free and uncounted. The SDKs and the MCP server run on your own machine with your own key.

import { Docustay } from "@docustay/sdk";
const docustay = new Docustay(process.env.DOCUSTAY_KEY);