---
title: "Create contact group"
url: "https://docs.signnow.com/docs/contact-groups/operations/post-v2-crm-groups"
type: "endpoint"
section: "contact-groups"
slug: "contact-groups/operations/post-v2-crm-groups"
method: "POST"
path: "/v2/crm/groups"
operation_id: "post-v2-crm-groups"
authorization: "bearer"
---

# Create contact group

`POST /v2/crm/groups`

This endpoint allows users to create the contacts group from your CRM contacts.

## Authorization

bearer

## Request Body

**Schema**

```json
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The new contact group name."
    }
  },
  "x-examples": {
    "Example 1": {
      "name": "My client`s group"
    }
  }
}
```

**Example** (`Example 1`)

```json
{
  "name": "My client`s group"
}
```

## Responses

### 201

Created

**Example** (`Created`)

```json
{
  "data": {
    "id": "29XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  }
}
```

### 400

* Request with any of these cases:

invalid token of user
expired token of user
empty header
authorization = null
authorization without value

* Request without group name or with empty group name
* Group name must be a string
* Group name contains invalid characters
* Group name length exceeded

**Example** (`Authorization issues`)

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

**Example** (`Group name length exceeded`)

```json
{
  "code": 27405005,
  "message": "Group name length must be not more than 40 characters"
}
```

**Example** (`Group name must be a string`)

```json
{
  "code": 27405003,
  "message": "Group name must be a string"
}
```

**Example** (`Group name contains invalid characters`)

```json
{
  "code": 27405004,
  "message": "Group name contains invalid characters"
}
```

**Example** (`Request without group name or empty group name`)

```json
{
  "code": 27405002,
  "message": "Group name is required"
}
```

### 405

Method Not Allowed

**Example** (`Not allowed to use this HTTP method`)

```json
{
  "message": "The GET method is not supported for this route. Supported methods: DELETE."
}
```

### 422

Group name already exists

**Example** (`Group name already exists`)

```json
{
  "code": 27405006,
  "message": "Group with such a name already exists"
}
```

## Code Examples

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

### cURL

```bash
curl -X POST \
  "https://api.signnow.com/v2/crm/groups" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My client`s group"}'
```

---
*Full reference: https://docs.signnow.com/docs/contact-groups/operations/post-v2-crm-groups*