OAuth providers

DocuSign

Set up DocuSign OAuth for electronic signatures and agreement management

Overview

Connect your users to DocuSign for electronic signature workflows, document management, and agreement automation.

Property	Value
Provider ID	`docusign`
Category	Business
PKCE	Supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create a DocuSign OAuth App

Open Apps and Keys

Sign in to DocuSign as an administrator and go to Settings > Apps and Keys — or open apps.docusign.com/admin/apps-and-keys directly. For developer accounts, use apps-d.docusign.com/admin/apps-and-keys.

Create a new application

Click ADD APP / INTEGRATION KEY, enter the App Name, and save.

Generate a secret key

Under Authentication, click Add Secret Key and copy the secret immediately — it is only displayed once.

Configure the redirect URI

Under Additional Settings, add a Redirect URI using the Alter callback URL from the Developer Portal. Match the trailing slash exactly — DocuSign requires an exact string match.

Get credentials

Copy the Integration Key (Client ID) shown on the app details page.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add DocuSign provider

Go to OAuth Providers > Add Provider > DocuSign.

Enter credentials

Client ID: Paste your DocuSign Integration Key
Client Secret: Paste your DocuSign Secret Key

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
`signature`	Send and sign documents
`extended`	Extended access for additional API endpoints
`impersonation`	Act on behalf of another user
`click.manage`	Manage ClickWrap agreements
`click.send`	Send ClickWrap agreements
`organization_read`	Read organization data
`permission_read`	Read permission profile data

Notes

DocuSign requires separate sandbox and production environments. Use the sandbox (account-d.docusign.com) for development.
The signature scope is required for most eSignature operations.
See the DocuSign OAuth documentation for more details.