---
title: "DocuSign Example"
slug: "docusign-example"
updated: 2026-06-03T17:58:02Z
published: 2026-06-03T17:58:02Z
canonical: "documentation.decisions.com/docusign-example"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DocuSign Example

## Overview

This example demonstrates how to administer a [DocuSign eSignature](https://www.docusign.com/products/electronic-signature) account with the DocuSign service. DocuSign eSignature provides a service to digitally sign legally-binding documents including contracts, account openings, and invoices.

> [!NOTE]
> **Intended audience:** Administrators, Process designers
> 
> **Tags:** DocuSign; Process design

### Prerequisites

To use DocuSign eSignature with the DocuSign, you require the following from the DocuSign platform:

- a DocuSign eSignature account
- at least one document template with at least one defined role from which to use with your document requiring signatures
- a DocuSign app to manage authentication and integration with ProcessMaker Platform

ProcessMaker Platform does not provide a DocuSign eSignature account. However, this example provides URLs to how to design a DocuSign eSignature template and DocuSign app.

## Prepare the Document for the DocuSign Platform

From the DocuSign platform, upload your document, create a DocuSign template, and then add at least one role in that template. This template dictates which signers are required to sign this document.

Follow these instructions from DocuSign to prepare your document:

- [Upload your document to the DocuSign platform](https://support.docusign.com/s/document-item?language=en_US&bundleId=fsk1642969066834&topicId=lbn1660168415318.html&_LANG=enus).
- [Create a DocuSign template for this document](https://support.docusign.com/s/document-item?language=en_US&bundleId=xry1643227563338&topicId=lsg1578456368117.html&_LANG=enus).
- When creating the DocuSign template, ensure to add the [recipient roles](https://support.docusign.com/s/document-item?language=en_US&bundleId=pik1583277475390&topicId=bcy1583277350761.html&_LANG=enus).

## Create a DocuSign App for This Document

From the DocuSign platform, create a DocuSign app. Get both the DocuSign integration key and the generated secret key from the DocuSign platform, and then add the redirect URI for the callback after DocuSign authenticates a valid DocuSign app in ProcessMaker Platform.

Follow DocuSign's guidelines to [create a DocuSign integration key](https://support.docusign.com/s/document-item?language=en_US&bundleId=pik1583277475390&topicId=lzz1583277395470.html&_LANG=enus), keeping the following points in consideration:

1. Select the **Authorization Code Grant** authentication type to generate a secret key for ProcessMaker.
2. Copy the **Integration Key** setting to use when [configuring ProcessMaker](/v1/docs/docusign-example#configure-processmaker-platform-settings-with-your-docusign-app).
3. Copy the Secret Key setting to use when [configuring ProcessMaker](/v1/docs/docusign-example#configure-processmaker-platform-settings-with-your-docusign-app).
4. In the ADD URI setting, enter the URL for the callback after DocuSign authenticates a valid DocuSign app in ProcessMaker Platform. Use the following format for this URI `https://<ProcessMakerPlatformURL>/docusign/authorization`, where `<ProcessMakerPlatformURL>` is the URL to your ProcessMaker Platform instance.
5. [Configure ProcessMaker Platform settings with your DocuSign app](/v1/docs/docusign-example#configure-processmaker-platform-settings-with-your-docusign-app).

## Configure ProcessMaker Platform Settings with Your DocuSign App

From your ProcessMaker Platform instance settings, add the DocuSign app's integration and secret key acquired from the DocuSign platform. This step may require the assistance of an Administrator.

**Permission**

Your user account or group membership must have the "Settings: View Settings" permission to view DocuSign settings unless your user account has the **Make this user a Super Admin** setting selected.

See the [Settings](/v1/docs/permission-descriptions-for-users-and-groups#settings) permissions or ask your Administrator for assistance.

Follow these steps to configure ProcessMaker Platform settings with your DocuSign account information for this document as [described in this example](/v1/docs/docusign-example#overview):

1. [Ensure that you have created the DocuSign app for your document, and then copied the integration and secret keys for that app](/v1/docs/docusign-example#create-a-docusign-app-for-this-document).
2. [Log on](/v1/docs/participant-basics#log-on-to-processmaker-platform) to ProcessMaker Platform.
3. Click the **Admin** option from the top menu. The **Users** page displays.
4. Click the **Settings** icon![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/a0b19a77-7563-449b-9c8f-0ba5e04f03c2.png)from the left sidebar. The **Settings** tab displays all Administrator settings.
5. Click the **DocuSign** tab.
6. Click the **Edit** icon![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/3434d3b9-d953-4429-b2d7-51dab35cc768.png)for the **Integration Key** setting. The **Integration Key** screen displays.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/25a8b996-8214-4ba3-b444-cbfb70638098.png)
7. Enter the DocuSign app's integration key you stored for later reference, and then click **Save**.
8. Click the **Edit** icon![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/3434d3b9-d953-4429-b2d7-51dab35cc768.png)for the **Secret** setting. The **Secret** screen displays.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/738da066-8df0-488f-bdca-262516a32a8f.png)
9. Enter the DocuSign app's secret key you stored for later reference, and then click **Save**.
10. Click the **Edit** icon![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/3434d3b9-d953-4429-b2d7-51dab35cc768.png)for the **Server** setting. The **Server** screen displays.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/a6f53a5d-b3b8-4bf6-963c-bd028d60ee7b.png)
11. Enter `https://account-d.docusign.com` as the DocuSign server name, and then click **Save**.
12. Click the **Grant DocuSign Access** button. A Task displays with a button labeled **Authorize Access DocuSign**.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/444e4b68-8ed1-4bcf-95cf-b5afe9238bff.png)
13. Click the **Authorize Access DocuSign** button to grant the DocuSign eSignature platform access to your ProcessMaker instance after it authenticates your DocuSign app.

The DocuSign for ProcessMaker Platform, via a Task, calls the DocuSign eSignature platform. In doing so, DocuSign returns the call as entered in the redirect URI for your DocuSign app. When successful, DocuSign requests access to your ProcessMaker Platform instance. (If you have already authorized your DocuSign app access, then the **Settings** page displays.) If a DocuSign error displays, ensure that the redirect URI configured in your DocuSign app is correct.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/44714df9-c75c-42ef-b6b7-ff56393943e2.png)
14. Click the **Allow Access** button.
15. [Configure the DocuSign connector for this document in your Process model](/v1/docs/docusign-example#configure-the-docusign-connector-for-this-document).

## Configure the DocuSign Connector for This Document

From your Process model, ensure that a DocuSign connector is in the Process to manage acquisition of the digital signatures for the document, and then configure that DocuSign connector.

**Permissions**

Your user account or group membership must have the following permissions to configure a DocuSign connector unless your user account has the **Make this user a Super Admin** setting selected:

- Processes: Edit Processes
- Processes: View Processes

See the [Process](/v1/docs/permission-descriptions-for-users-and-groups#processes) permissions or ask your Administrator for assistance.

Follow these steps to configure the DocuSign connector for this document this document:

1. [View your Processes](/v1/docs/view-edit-and-search-for-processes), and then click the **Open Modeler** icon![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/96592976-1919-4fb3-871a-0f90e327391d.png)to edit the selected Process model model to use DocuSign to manage signatures for this document.
2. [Add a DocuSign connector](/v1/docs/docusign-connector#add-a-docusign-connector-to-the-process-model) in the Process model.
3. Expand the **Document for Signature** panel. Settings for this panel display.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/0f314159-bc01-4c96-81d2-7ee68f0f9639.png)
4. From the **Template ID** setting, select the DocuSign template that references the document to send for eSignature. The template list populates from the DocuSign server specified in the [DocuSign Settings](/v1/docs/docusign-settings). For this example, use the template named **Vendor Agreement** since this is the name of the template [created for this example](/v1/docs/docusign-example#prepare-the-document-for-the-docusign-platform).
5. After selecting the DocuSign template, roles populate from the selected template. Select each role that is a recipient of the document for signing, and then configure the email recipient and message that displays to each role when this document sends to each recipient's email for signing. Configuring the email recipient associates the vendor with one of the following ProcessMaker Platform participant types that would receive the document to provide a signature:

  - **User:** Select the **User** option to specify a user as the document recipient. When selected, the **Send to User** setting displays below the **Select a Type** setting to select which user is the document recipient.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/50b7cdfb-1181-453f-ab62-0eddd0fc0149.png)
  - **Requester:** Select the **Requester** option to deliver the document to the Request starter for signature.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/e3ffb2a2-dc51-4b57-a066-fe7f508bce5e.png)
  - **User ID:** Select the **User ID** option to specify the user ID associated with a user as the document recipient. When selected, the **Send to User ID** setting displays below the **Select a Type** setting to enter the user ID associated with the user as the document recipient for signature.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/ff7b8525-f01e-45f8-815a-9696c9d78462.png)
  - **Email Address:** Select the **Email Address** option to enter the email address and name for the document recipient for signature. When selected, the **Recipient Email** and **Recipient Name** settings display below the **Select a Type** setting to enter the document recipient's email address and name, respectively.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/abe8450e-ee12-4bcc-b466-2c3f3b9fa0bd.png)
  - **Process Manager:** Select the **Process Manager** option to indicate that the [Process Manager](/v1/docs/process-management#who-is-a-process-manager) is the document recipient for signature.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/3fc86481-ff47-47e4-9732-64f2de5f1f70.png)
6. [Save the Process](/v1/docs/publish-your-process-model).

[Start a Request](/v1/docs/start-a-case) for the Process.