Introducing Recipient Groups for Signers and Approvers
You can now use Recipient Groups to add a pool of possible Signers or Approvers in your Signature Requests. The first member who acts signs or approves in their own name, and only their name appears on the signed Documents and the Audit Trail. The other members no longer need to act.
To create a group, use Create a new Signer or Create a new Approver with the same parameters as a single Signer (or Approver). The only difference: replace info with identity_pool, which is simply an array of info objects (at least 2). All other parameters apply to the whole group.
{
"identity_pool": [
{ "first_name": "Marie", "last_name": "Martin", "email": "[email protected]", "locale": "fr" },
{ "first_name": "Paul", "last_name": "Durand", "email": "[email protected]", "locale": "fr" }
],
"signature_level": "electronic_signature"
}How it works:
- A group has one ID, used in all the existing Signer and Approver endpoints.
- Only one member at a time can be in the signing flow. After 10 minutes of inactivity, another member can start.
- If a member declines or rejects, the whole Signature Request is declined or rejected.
- Only the member who signed can access the signed Documents and the Audit Trail.
- A group consumes one signature, whatever the number of members.
signer.doneandapprover.approvedare sent once, with the group ID and the member who signed ininfo. There is no new webhook event.- Only the Simple Electronic Signature is available for a group.
- You cannot sign or send an OTP for a group with the API (
/sign,/send_otp). The members sign from the Signature App or the Signature Portal.
The number of groups per Signature Request depends on your plan:
| Plan | Recipient Groups per Signature Request |
|---|---|
| Trial | 2 |
| Pro | 2 |
| Scale | Unlimited, within the limits of 100 Signers and 10 Approvers per Signature Request |
Group members count in the Signer and Approver limits of the Signature Request.
Recipient Groups are available on Pro and Scale plans, and during the Trial. In Sandbox, they are available on all plans, with the Pro plan limits.
group_with_id does not change: all the recipients of the same step must still act.

