Document Group

Document Group is an object with one ID that contains several documents. It helps automate signature requests for multiple documents from multiple signers.

What kind of documents can form a Document Group?

  • Must be owned by the person creating the Document Group.

  • Cannot be templates.

  • Cannot already be a part of another Document Group
    If you’d like to add such documents anyway, first - delete the other document group that contains them.
    To check if a document is a part of a Document Group, make a GET /document or GET /user/documents request. The "document_group_info" parameter must be an empty array. If it’s not empty and you’d like to use that document in another document group, copy a "document_group_id" from this array to delete that document group via a DELETE /documentgroup request.

  • At least one of the documents must have fields.

  • Documents don’t have field invites and signature requests ("field_invites" and "requests" parameters are both empty arrays)

  • Documents have not been signed (the "signature" parameter is an empty array)

  • Formats supported: PDF, DOCX

Before creating a Document Group, you should first have all the document IDs ready. Either save them from responses from the POST /document requests, or copy the IDs from the response from the GET /user/documents request.

Creating a Document Group
curl -X POST 'https://api-eval.signnow.com/documentgroup' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {{access_token}}' \
-H 'Content-Type: text/plain' \
-d '{
  "document_ids": [
    "dc7eef144204a4aa381363a82eb65577088be96a",
    "02fca9293046b9311a8c8295c002511974842406",
    "4af5fdd39289e9a5f2e1f6901cf5d6be1a17e0158",
    "382f939aec5ff9752e191b83f5f95441650d2d76"
  ],
  "group_name": "Document Group 1"
}'