← Help centre

Developers

API, SDKs and webhooks

Keys, test mode, the OpenAPI spec, SDKs, webhooks and embedded signing.

Keys

Create keys under Settings → API & webhooks. Test keys (dsk_test_) create watermarked agreements that aren't billed and work on every plan. Live keys (dsk_) need the Business plan or above.

Reference

The API is described at /api/v1/openapi.json, with examples on the Developers page. Node.js and Python SDKs are available.

Webhooks

Register an HTTPS endpoint for events such as envelope.completed. Each request carries X-DocSign-Signature: t=<unix>,v1=<hex>, an HMAC-SHA256 of t.body with your endpoint secret. Verify it before trusting the payload. Failed deliveries are retried with backoff.

Embedded signing

Create recipients with embedded: true and call POST /envelopes/{id}/recipients/{rid}/embedded-session for a one-time URL to show in an iframe on a site you allow under Settings → Organization.

AI assistants

An MCP server at /api/v1/mcp lets AI assistants look up, send, remind and void agreements with an API key.

Didn't find what you need? Search other articles or contact us.