---
title: "Docusign Recipients Table"
canonical: "https://help.agiloft.com/space/SD/44434520/Docusign+Recipients+Table"
format: markdown
---
The Docusign Recipients table stores records for each recipient of a Docusign envelope. The records are linked to the relevant [Docusign Envelope](https://agiloft-public.atlassian.net/wiki/spaces/SD/pages/44434051) record and Contract or Contract Request record the envelope was generated from.

# Creating Records

In the out-of-the-box system, Docusign Recipient records are created automatically when you create a Docusign envelope. A recipient record is created for each signer listed in the Contract or Contract Request record the envelope is created from. By default, Docusign Recipient records are owned by the envelope sender.

When necessary, you can also create Docusign Recipient records manually from Docusign Envelope records. Each recipient should have a different signing role for a given contract.

# 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 Recipients table includes the following fields.

| **Field Label** | **Data Type** | **Description** |
| --- | --- | --- |
| Access Code | Short Text | Optional code the recipient must enter to view the envelope. |
| Auto Responded Reason | Short Text | The response received from Docusign when a recipient's email server automatically rejects or responds to the email. |
| Decline Reason | Short Text | The reason the recipient gave for declining the envelope. |
| Declined | Date/Time | When the recipient declined the envelope. |
| Delivered | Date/Time | When the recipient first opened the envelope. |
| Docusign Role | Choice:<br>Certified Delivery, CC, Editor, Signer, Agent | The recipient's role in Docusign. |
| Envelope ID  
Envelope  
Linked ID  
Linked Table  
Linked Record  
Sender Login  
Sender | Link to selected fields from other table: DocuSign Envelope | Identifies the envelope the recipient received. |
| Full Name  
Title  
Email | Link to selected fields from other table: Person | The recipient's information from their Agiloft CLM record. |
| Latest Event | Choice:<br>delegate, finish-later, resent, reassign, completed, sent, declined, delivered, authentication failed, autoresponded, draft | The most recent event reported by Docusign for the recipient. |
| Message | Text | The body of the email sent to the recipient. |
| Recipient ID | Short Text | The unique identifier assigned to the recipient. |
| Role Name | Link to selected fields from other table: DocuSign Signing Roles | The signing role assigned to the recipient. |
| Send Order | Integer | The envelope routing order for the recipient. Recipients with lower numbers receive the envelope first. |
| Sent | Date/Time | When Docusign sent the envelope to this recipient. |
| Signed | Date/Time | When the recipient finished signing the envelope. |
| Status | Choice:<br>Auto Responded, Completed, Fax Pending, Signed, Declined, Sent, Delivered, Draft, Created | The recipient's current signing status in Docusign. |
| Subject | Short Text | The subject line of the email sent to the recipient. |

# Automation

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

- **Edit: Update Contract and Contract Request when Declined (web, API)**: This rule runs when records are edited. If a recipient declines the envelope or the envelope is otherwise voided, the rule changes the status of the linked Contract or Contract Request record. For Contracts, the status is changed to Pending Review and the Contract Manager is notified. For Contract Requests, the status is changed to Draft and the Requester is notified.