---
title: "Create document group"
method: POST
path: "/documentgroup"
---

# Create document group

`POST /documentgroup`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/documentgroup`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/documentgroup/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 list of document IDs.

All documents:
* Must be owned by the person creating the document group.
* Cannot be templates.
* Cannot already be a part of another document group (delete document group first to add them).
* Cannot have active or fulfilled invites.

For more information, check out our video tutorial.

<details open>

**<summary>Video tutorial</summary>**

<sub><sup>Note: The design shown in the video is outdated, but the flow is still accurate. You can go ahead and follow the steps as demonstrated.</sup></sub>

[Video tutorial](https://www.youtube.com/watch?v=5WJYRz6Szk0)

</details>

## Request body

- object
  - `group_name` string, required: Name of the document group.
  - `document_ids` string[], required: IDs of the documents to add to the document group.

## Response `200`

Document group successfully created.

- object
  - `id` string: ID of the new document group.

## Other responses

- `400`: * Wrong, expired, or missing token. * Incorrect payload. * Incorrect `document_ids` property. * `document_ids` array not containing documents. * Document not found. * Document not found or belongs to another user. * Document is a template. * Document already part of another document group. * Missing `group_name` property. * Document has active or fulfilled invites.

---

[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)