# Add group members

`POST /group.add`

## Description

Add one or more group members and/or admins.

Apps may add members to a group if one of the following conditions is true:
1. It is a public group in their Roam.
2. They are a member of the group.

If attempting to add an admin, the app must be an admin of the group.

**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 |
|----------|------|----------|-------------|
| `group` | TaggedUUID | Yes |  |
| `admins` | TaggedUUID[] | No | List of admin IDs |
| `members` | TaggedUUID[] | No | List of member IDs |

**TaggedUUID**:

A UUID prefixed by a tag identifying the specific type of object
**TaggedUUID** (array item):

*See TaggedUUID above*

**TaggedUUID** (array item):

*See TaggedUUID above*

### Example Request

```json
{
  "group": "G-88bebce7-6cbb-4666-96f9-5c02d73e6661",
  "members": [
    "U-709b8a57-70bc-427a-b6f0-b16ba5297f8c",
    "U-f589a8cb-78ac-493e-8719-0fa8a22f65e0"
  ],
  "admins": [
    "U-af6663d5-0f37-4105-95df-4fea20ef7c7c"
  ]
}
```

## Responses

### 204 - Members added successfully

### 400 - Invalid request, e.g. group does not exist or incorrect user IDs.

### 401 - Unauthorized.

### 403 - App does not have permission to add members to this group.

### 500 - An internal error occured.

---

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