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.

Request

HTTP request

PUT /v2.1/accounts/{accountId}/signing_groups/{signingGroupId}

Parameters

Parameter NameValueDescription
Path Parameters
accountIdstring

The external account number (int) or account ID GUID.

signingGroupIdstring

The id of the signing group of which the recipient is a member, if applicable.

Request Body

SigningGroups

Responses

CodeDescriptionReference
200

Successful response.

SigningGroups
400

Error encountered.

errorDetails

SDK Method

SigningGroups::update

Definitions

errorDetails

This object describes errors that occur. It is only valid for responses, and ignored in requests.

errorCodestring

A code associated with the error condition.

messagestring

A brief message describing the error condition.

signingGroupUser

emailstring

Filters returned user records by the specified email address.

errorDetailserrorDetails

Object that describes errors that occur. Only valid for responses; ignored in requests.

userNamestring

The name of the group member.

Maximum Length: 100 characters.

SigningGroups

Signing groups

createdstring

The UTC DateTime when the workspace user authorization was created.

createdBystring

errorDetailserrorDetails

Object that describes errors that occur. Only valid for responses; ignored in requests.

groupEmailstring

groupNamestring

The name of the group. The search_text provided in the call automatically performs a wild card search on group_name.

groupTypestring

The group type. Potential values for POST and PUT requests include:

  • adminstrators
  • everyone
  • customGroup

modifiedstring

modifiedBystring

User ID (GUID) of the user who last modified this user record.

signingGroupIdstring

When set to true and the feature is enabled in the sender's account, the signing recipient is required to draw signatures and initials at each signature/initial tab ( instead of adopting a signature/initial style or only drawing a signature/initial once).

users[signingGroupUser]

User management information.

Examples

Generic JSON Request/Response

Request
{
  "signingGroupId": "sample string 1",
  "groupName": "sample string 2",
  "groupType": "sample string 3",
  "groupEmail": "sample string 4",
  "created": "sample string 5",
  "createdBy": "sample string 6",
  "modified": "sample string 7",
  "modifiedBy": "sample string 8",
  "users": [
    {
      "userName": "sample string 1",
      "email": "sample string 2"
    }
  ]
}
Response
{
  "signingGroupId": "sample string 1",
  "groupName": "sample string 2",
  "groupType": "sample string 3",
  "groupEmail": "sample string 4",
  "created": "sample string 5",
  "createdBy": "sample string 6",
  "modified": "sample string 7",
  "modifiedBy": "sample string 8",
  "users": [
    {
      "userName": "sample string 1",
      "email": "sample string 2",
      "errorDetails": {
        "errorCode": "sample string 1",
        "message": "sample string 2"
      }
    }
  ],
  "errorDetails": {
    "errorCode": "SUCCESS",
    "message": ""
  }
}
Generic XML Request/Response

Request
<signingGroup xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.docusign.com/restapi">
  <created>sample string 5</created>
  <createdBy>sample string 6</createdBy>
  <groupEmail>sample string 4</groupEmail>
  <groupName>sample string 2</groupName>
  <groupType>sample string 3</groupType>
  <modified>sample string 7</modified>
  <modifiedBy>sample string 8</modifiedBy>
  <signingGroupId>sample string 1</signingGroupId>
  <users>
    <signingGroupUser>
      <email>sample string 2</email>
      <userName>sample string 1</userName>
    </signingGroupUser>
  </users>
</signingGroup> 
Response
<signingGroup xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.docusign.com/restapi">
  <created>sample string 5</created>
  <createdBy>sample string 6</createdBy>
  <errorDetails>
    <errorCode>SUCCESS</errorCode>
    <message></message>
  </errorDetails>
  <groupEmail>sample string 4</groupEmail>
  <groupName>sample string 2</groupName>
  <groupType>sample string 3</groupType>
  <modified>sample string 7</modified>
  <modifiedBy>sample string 8</modifiedBy>
  <signingGroupId>sample string 1</signingGroupId>
  <users>
    <signingGroupUser>
      <email>sample string 2</email>
      <errorDetails>
        <errorCode>sample string 1</errorCode>
        <message>sample string 2</message>
      </errorDetails>
      <userName>sample string 1</userName>
    </signingGroupUser>
  </users>
</signingGroup> 
}} />