Docusign
This Integration is part of the Docusign Pack.#
Supported versions
Supported Cortex XSOAR versions: 8.4.0 and later.
Docusign is a leading provider of electronic signature technology, allowing individuals and organizations to sign, send, and manage documents digitally.
Customer Events API#
The Docusign Monitor API provides access to customer events, which are events that occur in your Docusign account.
User Data API#
The Docusign Admin API provides access to user data, which is information about users in your Docusign account.
Go-Live - Customer events data type#
When you are ready to launch your app in production, you will need to promote your application’s integration key from your developer account to a production Docusign account by passing a Go-Live review, similar to the Go-Live process for the eSignature REST API.
Before you can begin the Go-Live process, you must have:
- A paid production Docusign account with a plan that includes Docusign Monitor
- Completed at least 20 consecutive successful test eSignature API requests in the developer environment
The 20 successful requests must be eSignature REST API requests, not Monitor API requests.
To start the Go-Live review for your application, follow the steps described on the Go-Live overview page for the Docusign eSignature REST API.
Note: If your application fails the Go-Live review, you may be required to bring it into compliance with the Rules and resource limits before proceeding.
Once the form is processed (which can take up to three business days), your integration key will be copied into production, enabling your app to call the production API endpoints.
API Endpoints#
The developer and production endpoints for most Docusign APIs use slightly different paths.
The table below shows the base endpoint paths for each DocuSign environment, helping you update your code when migrating from the developer environment to production.
| Environment | API base URI | Web Site Login URL |
|---|---|---|
| Developer | https://lens-d.docusign.net/api/v2.0/datasets/monitor/.. | https://account-d.docusign.com |
| Production | https://lens.docusign.net/api/v2.0/datasets/monitor/... | https://{server}.docusign.net/ |
Note: To access production API endpoints, you will need to enable your integration key in the production environment. See Go-Live for more information.
Go-Live - Audit Users data type#
Before you can begin the Go-Live process for an app that uses the Admin API, you must have:
- Admin API access enabled for your account
- Completed at least 20 consecutive successful test eSignature API requests in the developer environment
The 20 successful requests must be API Reference requests, not Admin API requests.
When you are ready to start the Go-Live review for your application, follow the steps described on the Go-Live overview page for Docusign eSignature.
Note: If your application fails the Go-Live review, you may need to bring it into compliance with the API rules and resource limits before proceeding.
After the form is processed, your integration key is copied to your production account, enabling your app to call production Admin API endpoints.
Note that while the key is copied, you must configure all required values separately in the production environment; configuration settings are not copied automatically.
API Endpoints#
The developer and production endpoints for the Admin API use slightly different paths.
The examples in the how-to section use the developer paths; the table below shows the production version of the base path.
| Environment | Admin API base URI | eSignature API base URI |
|---|---|---|
| Developer | https://api-d.docusign.net/management/ | https://demo.docusign.net/ |
| Production | https://api.docusign.net/management/ | https://{server}.docusign.net/ |
Configure Docusign in Cortex#
| Parameter | Description | Required |
|---|---|---|
| Server URL | True | |
| Integration Key | True | |
| User ID | True | |
| Redirect URL | True | |
| Private Key | True | |
| Account ID | For fetching user data only | False |
| Organization ID | For fetching user data only | False |
| Fetch events | False | |
| Event types to fetch | False | |
| Maximum number of customer events per fetch | Due to API limitations, the maximum is 2000. | False |
| Maximum number of user data events per fetch | Due to API limitations, the maximum is 1250. | False |
| Trust any certificate (not secure) | False | |
| Use system proxy settings | False |
Commands#
You can execute these commands from the CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room showing the command details.
docusign-generate-consent-url#
Generates the Docusign admin consent URL based on configured parameters and environment.
Base Command#
docusign-generate-consent-url
Input#
There is no input for this command.
Context Output#
There is no context output for this command.
Command Example#
!monday-generate-login-url
Human Readable Output#
Docusign Consent URL#
[Click here to authorize]
docusign-reset-access-token#
Resets the access token stored in the integration context.
Base Command#
docusign-reset-access-token
Input#
There is no input for this command.
Context Output#
There is no context output for this command.