---
title: "Create doc group from template"
method: POST
path: "/v2/document-group-templates/{unique_id}/document-group"
---

# Create doc group from template

`POST /v2/document-group-templates/{unique_id}/document-group`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/document-group-templates/{unique_id}/document-group`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/document-group-templates/:unique_id/document-group/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to create a document group from a document group template.

The new document group is a signable copy: the template stays untouched as the master version. The documents in the group have new IDs that differ from the ones in the template, so build any invite from the IDs returned by this request. For the full flow, from preparing the documents to sending the group for signature, see [Documents, doc groups, and templates](/docs/entities). To let recipients sign the group inside your own site or app, see [Embedded signing](/docs/guides-embedded-signing).

## Request body

- object
  - `folder_id` string: ID of the folder
  - `group_name` string, required: Name of the Document Group
  - `client_timestamp` string: Timestamp of client

## Response `200`

Successfully created document group

- object
  - `data` object: Document group created from the template.
    - `name` string: Name of the document group.
    - `owner` object: Owner of the document group.
      - `id` string: ID of the owner.
      - `email` string: Email address of the owner.
      - `organization` object: Organization the owner belongs to.
        - `id` string: ID of the organization. `null` if the owner is not in an organization.
    - `state` string: State of the document group. `created` for a new document group.
    - `created` integer: Unix timestamp of when the document group was created.
    - `documents` object[]: Documents in the document group.
      - `id` string: ID of the document.
      - `roles` string[]: Roles assigned in the document. Empty if the document has no roles.
      - `thumbnail` object: Thumbnail URLs of the first page of the document.
        - `large` string: URL of the large thumbnail.
        - `small` string: URL of the small thumbnail.
        - `medium` string: URL of the medium thumbnail.
      - `document_name` string: Name of the document.
      - `origin_document_id` string: ID of the source document if this document was created as a copy. `null` otherwise.
      - `has_unassigned_field` boolean: `true` if the document has fields not assigned to any role.
      - `has_credit_card_number` boolean: `true` if the document has a credit card number field.
    - `invite_id` string: ID of the active document group invite. `null` for a new document group.
    - `unique_id` string: ID of the document group.
    - `owner_email` string: Email address of the document group owner.
    - `last_invite_id` string: ID of the last invite sent for the document group. `null` for a new document group.

## Other responses

- `400`: - Wrong, expired, or missing token. - Wrong payload. - Incorrect folder_id property. - Incorrect client_timestamp property. - folder_id not found or deleted. - group_name property is empty. - Folder does not have enough permissions. - Folder does not exist. - Something happened during copying file. - User doesn't have rights to write into folder.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)