---
title: "Docusign Envelopes Table"
canonical: "https://help.agiloft.com/space/SD/44434051/Docusign+Envelopes+Table"
format: markdown
---
The Docusign Envelopes table stores a record for each Docusign envelope that has been created. The records link to the Contract or Contract Request record they were created from and include the attached documents and list of envelope recipients.

# Creating Records

Docusign Envelope records are typically created using the Create Docusign Envelope button in Contract or Contract Request records. By default, the button is set up to run the `ext:Create DocuSign Envelope` action, which packages the documents in the Files to Sign field into an envelope and adds the internal and external signers specified in the parent record as recipients. For more information on working with Docusign envelopes, see [Create and Send Docusign Envelopes](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/599064639) in the CLM Help.

The status of an envelope is updated automatically based on its progress in Docusign. Once it’s sent to Docusign, it has a status of Created. As each recipient signs the envelope, the status of the Recipient record is updated to Completed.

Docusign Envelope records are owned by the user who sent the envelope.

# Fields

In addition to the [standard fields](https://agiloft-public.atlassian.net/wiki/spaces/SD/pages/44434023/Table+Concepts#standard_fields), the out-of-the-box Docusign Envelopes table includes the following fields.

| **Field Label** | **Data Type** | **Description** |
| --- | --- | --- |
| Attached Documents | File | Lists the documents in the envelope. |
| Combine with Certificate of Completion | Choice: Yes, No | Controls whether Agiloft CLM stores the completed documents together with Docusign’s certificate of completion. |
| Completed | Date/Time | Records when all required recipients completed the envelope. |
| Contract Request Contract ID  
Contract Request ID | Link to selected fields from other table: My Contract Requests | Identifies the linked Contract Request. |
| Contract Start Date  
Contract ID  
Internal Contract Owner | Link to selected fields from other table: Contracts | Identifies the linked Contract. |
| Create & Preview | Action button | Creates an envelope and opens it in Docusign so you can preview it. |
| Decline Reason | Text | Stores the reason the envelope was declined. |
| Declined | Date/Time | Records when the envelope was declined. |
| Declined By  
Declined By ID | Link to selected fields from other table: People | Identifies the person who declined the envelope. |
| Deleted | Date/Time | Records when the envelope was deleted. |
| Delivered | Date/Time | Records when the envelope was first opened by a recipient. |
| Discard | Action button | Deletes the envelope, linked recipients, and the envelope record. |
| DocuSign Template | Short Text | Lists the Docusign template used for the envelope. |
| Edit Envelope | Action button | If the envelope status is Sent or Delivered, you can use this button to open the envelope for editing in Docusign. |
| Envelope | Short Text | Lists the Docusign envelope ID. |
| eSignature Documents | File | Stores the signed documents. Gets updated as recipients complete the signing. |
| Latest Event | Choice:<br>deleted, discard, corrected, purge, declined, voided, delivered, completed, sent, resent, draft, created | Lists the most recent Docusign event. |
| Linked Record | Short Text | Lists the linked record. |
| Move to Deleted | Action button | Flags the envelope for deletion and deletes it. |
| Recipients | Related Table | The list of envelope recipients. |
| Send | Action button | Sends the envelope to the recipients. |
| Sender  
Sender Login | Link to selected fields from other table: People | Identifies who sent the envelope. |
| Sent | Date/Time | Records when the envelope was sent. |
| Signed | Date/Time | Records when signing was completed for the envelope. |
| Status | Choice:<br>Template, Correct, Authoritative Copy, Transfer Completed, Voided, Timed-out, Completed, Declined, Delivered, Signed, Deleted, Sent, Created, Draft | The current state of the envelope. |
| Status Updated | Date/Time | Records when the status was last updated. |
| Subject | Short Text | The subject line of the email sent to recipients. |
| Timed Out | Date/Time | Records when the envelope timed out or expired. |
| Update Envelope Status | Action button | Enables you to update the envelope status. Not included in the record layout by default. |
| Use DocuSign Template | Choice: Yes, No | Controls whether the envelope is created from a Docusign template. |
| Void | Action button | Voids the envelope. |

# Automation

This section describes the rules that are implemented for the out-of-the-box Docusign Envelopes table. For details about rule configuration options, see [Rules](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714473) in the CLM Help.

- **Edit: Set Contract to Pending Signature when Envelope is sent (web, API)**: This rule runs when records are edited. For records where the Status changed to Sent, it changes the related Contract record's status to Pending Signature.
- **Edit: Convert to Attachments and set Contract to Signed when Status is Completed, API only**: This rule runs when records are edited. For records where the Latest Event field changed to Completed, it updates the Contract Status to Signed and, if applicable, sets the Contract Request to Executed. It also creates a new Attachment record for the signed documents.
- **Create: If linked table is Contract Request, set Contract Request ID and Contract ID, and set DocuSign Envelope ID in Contract Request (web, API)**: This rule runs when records are created. If the record was created from a Contract Request record, the rule sets the Contract Request ID and Contract ID in the Envelope record and sets the Envelope ID in the Contract Request.