{"api":"esign_rest","category":"reference"}

SigningGroups Resource

The SigningGroups resource provides methods that allow you manage signing groups.

Signing Groups allow you to create a group of people to which an envelope is sent. Any member of that group can open an envelope and sign the documents in the envelope with their own signature, even though a signature field was not directly assigned to them. When the Signing Group option is used, group members that open and sign the envelope are tracked in the envelope history and certificate.

When one group member opens the envelope, it is temporarily locked and if other members try to open the envelope they will see a message saying the envelope is currently opened. If the group member exits the envelope without finishing the lock expires, allowing other group members to open and complete the envelope.

When the envelope is complete, all members of the group will receive a completed notification and can access the completed envelope. The envelope history and Certificate of Completion will show that the envelope was sent to a signing group and record which members viewed and signed the envelope.

An account can have a maximum of 50 signing groups. Each signing group can have a maximum of 50 group members.

The Signing Groups feature is only supported in certain DocuSign Enterprise and System Automated Premium plans. Your account might not support this option. To access this functionality, contact your Account Manager or DocuSign Support (support@docusign.com) for assistance.

MethodDescription
list
GET /v2/accounts/{accountId}/signing_groups

Retrieves a list of all signing groups in the specified account.

updateList
PUT /v2/accounts/{accountId}/signing_groups

Updates the name of one or more existing signing groups.

create
POST /v2/accounts/{accountId}/signing_groups

Creates one or more signing groups.

Multiple signing groups can be created in one call. Only users with account administrator privileges can create signing groups.

An account can have a maximum of 50 signing groups. Each signing group can have a maximum of 50 group members.

Signing groups can be used by any account user.

delete
DELETE /v2/accounts/{accountId}/signing_groups

Deletes one or more signing groups in the specified account.

get
GET /v2/accounts/{accountId}/signing_groups/{signingGroupId}

Retrieves information, including group member information, for the specified signing group.

update
PUT /v2/accounts/{accountId}/signing_groups/{signingGroupId}

Updates signing group name and member information. You can also add new members to the signing group. A signing group can have a maximum of 50 members.