# Create a group

`POST /group.create`

## Description

Create a group address that can be used for chat.

Groups which specify an admin will operate in an "Admin only" management
mode, where only admins may change settings. Otherwise, all members have
that capability.

Groups require at least one member or admin.
Admins appear only in the admin list, not in both.

**Access:** Organization only.

**Required scope:** `group:write`

---

**OpenAPI Spec:** [chat.json](https://developer.ro.am/chat.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | string | Yes |  |
| `description` | string | No |  |
| `private` | boolean | No |  |
| `enforceThreads` | boolean | No |  |
| `members` | string[] | No | Member email addresses or IDs |
| `admins` | string[] | No | Admin email addresses or IDs |

### Example Request

```json
{
  "name": "Engineering Team",
  "description": "Channel for engineering discussions and updates",
  "private": false,
  "enforceThreads": true,
  "members": [
    "alex.chen@example.com",
    "taylor@example.com"
  ],
  "admins": [
    "jordan.smith@example.com"
  ]
}
```

## Responses

### 200 - Group created successfully

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | TaggedUUID | No | The ID of the newly created group |
| `name` | string | No | The name of the group |
| `private` | boolean | No | Whether the group is private |
| `dateCreated` | string | No | When the group was created |

**TaggedUUID**:

A UUID prefixed by a tag identifying the specific type of object

#### Example Response

```json
{
  "id": "G-88bebce7-6cbb-4666-96f9-5c02d73e6661",
  "name": "Engineering Team",
  "private": false,
  "dateCreated": "2026-01-21T10:30:00Z"
}
```

### 400 - Bad request.

### 401 - Presented invalid authentication credentials.

### 405 - An unsupported method was requested.

### 500 - An internal error occured.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/chat-api/group-create*