---
title: "New Group (POST)"
slug: "post-new-group"
updated: 2023-08-01T07:55:41Z
published: 2023-08-01T07:55:41Z
canonical: "support.perimeter81.com/post-new-group"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.perimeter81.com/llms.txt
> Use this file to discover all available pages before exploring further.

# New Group (POST)

<meta charset="utf-8">

### POST /v1/groups

Create an access group that holds applications, networks, VPN locations, and users.

**Parameters**: None

**Request Body**: [CreateGroupDto](/v1/docs/schemas-1)

**Request Example**:

```shell
curl -X POST -H 'Authorization: Bearer <ACCESS_TOKEN>' -H 'Content-Type: application/json' \
-d '{ 
	"name": "<NAME>", 
	"description": "<DESCRIPTION>" 
}' 'https://api.perimeter81.com/api/rest/v1/groups'
```

<meta charset="utf-8">

**Response Body**:

| Status Code | Message/Response Body | Description |
| --- | --- | --- |
| 201 | [](https://support.perimeter81.com/v1/docs/schemas)[Group Schema](/v1/docs/schemas-1)[](https://support.perimeter81.com/v1/docs/schemas) | Success. The resource was created. |
| 400 |  | Bad request. |
| 401 | Unauthorized | Wrong or expired [Access Token](https://support.perimeter81.com/v1/docs/authorize) |

**Response Example (201)**:

```json
{
  "tenantId":"<TENANT_ID>",
  "name":"<GROUP_NAME>",
  "description":"<GROUP_DESCRIPTION>",
  "isDefault":false,
  "applications":[],
  "networks":[],
  "vpnLocations":[],
  "users":[],
  "createdAt":"2021-09-29T16:45:48.968Z",
  "updatedAt":"2021-09-29T16:45:48.969Z",
  "id":"zyKN1cBLpc"
}
```