Integrating DocuSign
Auth: OAuth 2.0 · Partner program: not required · Setup time: about 20 minutes · Last verified: 2026-05-20
DocuSign is the reference adapter for the docsign vertical. It exposes the full canonical surface — envelopes, signers, documents (metadata only), audit-trail entries, templates — against the DocuSign eSignature REST API v2.1.
Auth model
Section titled “Auth model”- OAuth 2.0 Authorization Code grant. Authorize at
https://account-d.docusign.com/oauth/auth(demo) oraccount.docusign.com(prod). Exchange via Basic-auth POST to/oauth/token. - The token exchange follows up with
GET /oauth/userinfoto resolve the user’s default account, account name, andbase_uri(the per-account API host).
Prerequisites
Section titled “Prerequisites”- A DocuSign developer account at developers.docusign.com.
- In My Apps & Keys, create an integration using Authorization Code Grant.
- Add
<base-url>/auth/docsign/docusign/callbackto the integration’s redirect URIs. - Note the Integration Key (client id) and Secret Key (client secret).
Configure in admin
Section titled “Configure in admin”- Open
/platformsin the admin UI, filter to Docsign, click DocuSign. - Fill Configure:
clientId— your Integration Key.clientSecret— your Secret Key.redirectUri—${PUBLIC_BASE_URL}/auth/docsign/docusign/callback.
- Enable the adapter.
Required scopes
Section titled “Required scopes”Default scopes: signature impersonation. impersonation is required if you intend to add a JWT Grant flow alongside the auth-code flow.
Webhooks (DocuSign Connect)
Section titled “Webhooks (DocuSign Connect)”DocuSign Connect signs JSON deliveries with HMAC-SHA256 in X-DocuSign-Signature-1 (base64). Configure Connect to deliver JSON. Key rotation supported via -2 / -3 headers — the verifier accepts any matching signature.
Subscribe to: Envelope Sent, Envelope Delivered, Envelope Completed, Envelope Declined, Envelope Voided, Recipient Completed, Recipient Declined.
Refused at the wire
Section titled “Refused at the wire”The adapter never calls GET /envelopes/{id}/documents/{documentId} with a non-metadata content type. Document content stays on DocuSign servers.
Sandbox vs production
Section titled “Sandbox vs production”The adapter defaults to the demo environment (account-d.docusign.com). To target production, edit apps/integration-server/src/verticals/docsign/adapters/docusign/constants.ts and swap OAUTH_*_URL to the account.docusign.com equivalents.
opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.