---
title: "Create doc group template"
url: "https://docs.signnow.com/docs/document-group-template/operations/post-v2-document-group-templates"
type: "endpoint"
section: "document-group-template"
slug: "document-group-template/operations/post-v2-document-group-templates"
method: "POST"
path: "/v2/document-group-templates"
operation_id: "post-v2-document-group-templates"
authorization: "bearer"
---

# Create doc group template

`POST /v2/document-group-templates`

This endpoint allows users to create an empty document group template. Once the document group template is created, users can add one or more templates or documents to this document group template.

A successful request returns a document group template ID.


## Authorization

bearer

## Request Body

**Schema**

```json
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "example": "Test document group template",
      "description": "Document group template name.\n"
    },
    "folder_id": {
      "type": "string",
      "example": "5fcac949dce4e1d23e54ea5751dd649a947abbbb",
      "description": "ID of the templates folder that will be used to create a document group template. If provided, must refer to a valid and accessible folder of templates."
    }
  },
  "x-examples": {
    "Example 1": {
      "name": "Document group template name",
      "folder_id": "5fcac949dce4e1d23e54ea5751dd649a947abbbb"
    }
  }
}
```

**Example** (`Example 1`)

```json
{
  "name": "Document group template name",
  "folder_id": "5fcac949dce4e1d23e54ea5751dd649a947abbbb"
}
```

## Responses

### 200

Success.

**Example** (`Example 1`)

```json
{
  "data": {
    "id": "b12e4a885b513a6d9c4c2e7c2b7fa06a013a7412"
  }
}
```

**Example** (`Successful request`)

```json
{
  "data": {
    "id": "b12e4a885b513a6d9c4c2e7c2b7fa06a013abbbb"
  }
}
```

### 400

- `name` is empty.
- `name` is not a string.
- `name` has unsupported symbols.
- `name` length is too long.
- Authorization is required.
- `folder_id` is empty.
- `folder_id` is not a string.
- `folder_id` is incorrect.
- `folder_id`is not a folder of templates.
- `folder_id` is not accessible.

**Example** (`Example 1`)

```json
{
  "errors": [
    {
      "code": 13024001,
      "message": "The `name` value should not be blank."
    }
  ]
}
```

**Example** (`name is empty`)

```json
{
  "errors": [
    {
      "code": 13024001,
      "message": "The `name` value should not be blank."
    }
  ]
}
```

**Example** (`name too long`)

```json
{
  "errors": [
    {
      "code": 13024004,
      "message": "The `name` value is too long. It should have 255 characters or less."
    }
  ]
}
```

**Example** (`Empty folder_id`)

```json
{
  "errors": [
    {
      "code": 13024005,
      "message": "The `folder_id` value should not be blank."
    }
  ]
}
```

**Example** (`name not string`)

```json
{
  "errors": [
    {
      "code": 13024002,
      "message": "The `name` value should be of type string."
    }
  ]
}
```

**Example** (`folder_id not string`)

```json
{
  "errors": [
    {
      "code": 13024006,
      "message": "The `folder_id` value should be of type string."
    }
  ]
}
```

**Example** (`Authorization required`)

```json
{
  "code": 1537,
  "error": "invalid_token"
}
```

**Example** (`folder_id is incorrect`)

```json
{
  "errors": [
    {
      "code": 13024007,
      "message": "The `folder_id` value is invalid unique id."
    }
  ]
}
```

**Example** (`folder_id not accessible`)

```json
{
  "errors": [
    {
      "code": 13029002,
      "message": "User folder is not accessible."
    }
  ]
}
```

**Example** (`name has unsupported symbols`)

```json
{
  "errors": [
    {
      "code": 13024003,
      "message": "The `name` value is not valid."
    }
  ]
}
```

**Example** (`folder_id not templates folder`)

```json
{
  "errors": [
    {
      "code": 13029001,
      "message": "Folder of Templates available only."
    }
  ]
}
```

## Code Examples

> Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running.

### cURL

```bash
curl -X POST \
  "https://api.signnow.com/v2/document-group-templates" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Document group template name", "folder_id": "5fcac949dce4e1d23e54ea5751dd649a947abbbb"}'
```

---
*Full reference: https://docs.signnow.com/docs/document-group-template/operations/post-v2-document-group-templates*