How can I send an envelope to a group of signers?

Zoho Sign allows users to send envelopes to a group of recipients and have any member of the group sign the document.

How does this work?

You need to pass "is_signing_group" : true and "signing_group_id":<value> instead of recipient_name, recipient_email under actions.

Note: If verify_recipient is true, ensure phone numbers are added for all recipients in the signer group.
 

Learn how to create a signer group.

Learn how to retrieve a signer group id.

Request example

Copieddata = 
{
  "requests": {

    "request_type_id": "5000000000527",
    "request_name": "Test Signing group",
    "actions": [
      {
        "action_type": "SIGN",
        "private_notes": "",
        "language": "en",
        "delivery_mode": "EMAIL",
        "signing_order": 1,
        "is_signing_group": true,
        "signing_group_id": "5000000005001",
        "verify_recipient": false
      }
    ],
    "notes": "",
    "expiration_days": 15,
    "is_sequential": true,
    "email_reminders": true,
    "reminder_period": 5,
    "validity": -1,
    "deleted_actions": []
  }
}

Response example

Copied{
 "code": 0,
 "requests": {
 "request_status": "draft",
 "notes": "",
 "reminder_period": 5,
 "owner_id": "5000000002007",
 "description": "",
 "request_name": "Test Signing group",
 "modified_time": 1747839614403,
 "is_deleted": false,
 "expiration_days": 15,
 "is_sequential": true,
 "templates_used": [],
 "owner_first_name": "Zoho Sign",
 "sign_percentage": 0,
 "owner_email": "support@zohosign.com",
 "created_time": 1747838545937,
 "email_reminders": true,
 "self_sign": false,
 "document_fields": [
 {
 "document_id": "5000000005042",
 "fields": []
 }
 ],
 "in_process": false,
 "validity": -1,
 "request_type_name": "Others",
 "request_id": "5000000005041",
 "request_type_id": "5000000000527",
 "owner_last_name": "",
 "actions": [
 {
 "verify_recipient": false,
 "action_type": "SIGN",
 "private_notes": "",
 "cloud_provider_name": "Zoho Sign",
 "send_completed_document": true,
 "is_bulk": false,
 "action_id": "5000000005061",
 "signing_group": {
 "signing_group_name": "Test Signing group 1",
 "signing_group_count": 5,
 "signing_group_id": "5000000005001"
 },
 "signing_order": 1,
 "cloud_provider_id": 10,
 "signing_group_id": "5000000005001",
 "fields": [],
 "delivery_mode": "EMAIL",
 "action_status": "NOACTION",
 "is_signing_group": true
 }
 ]
 },
 "message": "Document has been updated",
 "status": "success"
}