---
title: "Create a visitor group"
method: POST
path: "/rooms/{id}/groups"
tags: ["Rooms"]
---

# Create a visitor group

`POST /rooms/{id}/groups`

## Request

- Base URL: `https://dataroom.corgi.com/api/v1`
- URL: `https://dataroom.corgi.com/api/v1/rooms/{id}/groups`
- Auth: HTTP bearer

Duplicate names 409. Scope: `datarooms:permissions`.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string, required
  - `color` string
  - `defaultLevel` 'NONE' | 'VIEW' | 'COMMENT' | 'EDIT' | 'OWNER'
  - `ndaRequired` boolean
  - `watermark` boolean
  - `allowDownload` boolean

## Response `201`

Created

## Other responses

- `409`: Duplicate name

---

[API](https://skmtc.dev/corgi/apis/dataroom-api.md) - [All operations](https://skmtc.dev/corgi/apis/dataroom-api/llms.txt) - [OpenAPI document](https://skmtc.dev/corgi/apis/dataroom-api/revisions/73f75ef04a00?raw)