Adds one or more new members to a signing group. A signing group can have a maximum of 50 members.

Request

HTTP request

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

Parameters

Parameter name Value Description
Path parameters
accountId string

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

signingGroupId string

Request Body

Responses

Code Description Reference
200 OK Successful response.
400 Bad Request Error encountered.

SDK Method

SigningGroups::updateUsers

Definitions Expand All | Collapse All

SigningGroupUsers

Signing groups' users

users
[signingGroupUser]

errorDetails

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

errorCode string

An error code associated with the error.

message string

A short error message.

signingGroupUser

email string
errorDetails errorDetails
userName string

The name of the group member.

Maximum Length: 100 characters.

Examples

Generic JSON Request/Response

Request

{
"users": [
{
"userName": "sample string 1",
"email": "sample string 2"
}
]
}

Response

{
"users": [
{
"userName": "sample string 1",
"email": "sample string 2",
"errorDetails": {
"errorCode": "sample string 1",
"message": "sample string 2"
}
}
]
}

Generic XML Request/Response

Request

<signingGroupUsers 
xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.docusign.com/restapi">

<users>
<signingGroupUser>
<email>sample string 2</email>
<userName>sample string 1</userName>
</signingGroupUser>
</users>
</signingGroupUsers>

Response

<signingGroupUsers 
xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.docusign.com/restapi">

<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>
</signingGroupUsers>