DocuSign

DocuSign operates a cloud-based electronic signature platform that helps small- and medium-sized businesses, enterprises, and individuals collect information, automate data workflows, and electronic signatures on various devices.

DocuSign automates manual and paper-based processes and allows users to manage authentication, digital signature, forms and data collection, collaboration, and workflow automation and storage.

Important:Note the following current SaaS Management integration limitations with DocuSign:

The DocuSign integration setup supports only a production/live account.
For organizations with multiple accounts configured in DocuSign, SaaS Management does not show the relationship of the licenses and users to each account.

The following sections describe the DocuSign integration with SaaS Management in further detail.

Information Stored
Minimum Permissions Required
Authentication Method
Credentials Required
License Types
Integrating DocuSign with SaaS Management
Auto-Populated DocuSign License Information
Managing Available DocuSign Licenses
API Endpoints

Information Stored

The following table describes the available integration tasks and stored data.

Available Integration Tasks

Integration Task

Information Stored

Application Roster

User ID
Email
First Name
Last Name
Active Date (Created Date and Time)
Plan Name

Application Access

Last Login
User ID

License Differentiation

See License Types and Tracking Application Activity by License Type for License Differentiation.

License Information

Plan Name
Plan ID
Items Allowed

Note:The above license information is retrieved every 24 hours. Therefore, the data in your DocuSign Billing may not match the data in SaaS Management for license information.

Reclamation

For details, refer to Reclaiming SaaS Licenses.

Note:Note the following:

The information stored is subject to change as enhancements are made to the product.
Currently due to an API limitation in DocuSign, the SaaS Management integration with DocuSign retrieves the last_login activities only when you directly sign in to the DocuSign portal. When you sign in through a Single Sign-On (SSO) provider, those activities are not captured by DocuSign APIs. To track DocuSign last_login activities through an SSO integration, navigate to the SSO integration’s Integrated Applications Tab and click the DocuSign link in the App Name column. When the DocuSign (Integrated via SSO) screen opens, click the Users tab and filter by the Last Activity column.

Minimum Permissions Required

Minimum API required permissions are based on the Scopes Required and User Permission Profile .

Scopes Required

Scopes Required

Scopes Required

Description

Integration Task Name

Extended

Used when requesting an access token

Required for authorization

Signature

Required to call API endpoints for eSignature

Application Roster

Application Access

License Information

Reclamation

User Permission Profile

User Permission Profile

User Permission Profile

Description

Integration Task Name

DS Admin (Administrator)

This permission is required to authorize the above-mentioned scopes.

Application Roster

Application Access

License Information

Reclamation

Authentication Method

OAuth2 with Authorize flow. For details, refer to DocuSign’s documentation: How to get an access token with Authorization Code Grant.

Credentials Required

Username
Password

Note:Username and Password are required only for authorizing the application. They are not stored in SaaS Management.

License Types

Your organization’s DocuSign plan can have multiple users in a single account based on the subscribed plan and pricing. All users fall under the same plan and pricing of the parent account.

Following are the available DocuSign plans to date:

eSignature Plans and Pricing
Personal
Standard
Business Pro
Developer Plans and Pricing
Real Estate Plans and Pricing

Integrating DocuSign with SaaS Management

To integrate DocuSign with SaaS Management, perform the following steps.

To integrate DocuSign with SaaS Management:

1. Add the DocuSign application in SaaS Management. Refer to Adding an Application.
2. After clicking Authorize, you will be directed to the DocuSign login portal.
3. Enter the DocuSign Username and Password of the Administrator user and click Accept to authorize the required permissions for calling the APIs used in the Integration.
4. For further information on managing and optimizing your organization’s DocuSign licenses, refer to:
Auto-Populated DocuSign License Information
Managing Available DocuSign Licenses
Tracking Application Activity by License Type for License Differentiation
Reclaiming SaaS Licenses.

Auto-Populated DocuSign License Information

The SaaS Management integration with DocuSign offers a License Information integration task that automatically retrieves every 24 hours the name of the DocuSign plan, license type, and total allowed number of licenses. This auto-populated DocuSign license information provides a more complete view of your DocuSign SaaS entitlements and component usage by displaying:

Assigned entitlements
User’s license activity (based on the user’s last login).

Important:If you enable the License Information integration task, you need to enter and keep up to date the following Licenses Tab information. The License Information integration task does not pull in this information. The SaaS application’s annual spend calculation relies on entered and accurate license effective and ending dates.

Amount 
Currency 
Payment Frequency 
Effective Date 
Ending Date 

To auto-populate DocuSign license information, refer to Auto-Populated Managed SaaS Application License Information. When the License Information integration task is enabled, the License type, Name, and # of Items Allowed fields in the DocuSign Licenses tab are disabled as this information is automatically populated. The active and inactive ingested license data from DocuSign can be compared against your DocuSign Billing.

Managing Available DocuSign Licenses

Once the License Information integration task for Auto-Populated DocuSign License Information is enabled, you can add or remove the DocuSign product licenses you wish to manage within SaaS Management. To manage available DocuSign licenses, refer to Managing Available SaaS Application Licenses.

API Endpoints

Application Roster and Application Access

https://account.docusign.com/oauth/userinfo (Use this API endpoint to obtain the base URL and account ID, which are used for the below API endpoint) 
https://<<base_url>>/restapi/v2/accounts/<<account_Id>>/users 

License Information

https://<<base_url>>/restapi/v2/accounts/<<account_Id>>/billing_plan

Reclamation

https://<<base_url>>/restapi/v2/accounts/<<account_Id>>/users