---
title: "Create chat (v2)"
method: POST
path: "/v2/chats"
tags: ["Chats"]
---

# Create chat (v2)

`POST /v2/chats`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/chats`
- Auth: HTTP bearer

**Auth**: User JWT

Create chat (v2)

## Request body

- object
  - `title` string: Display name shown in the chat list and at the top of the room. Free-form.
  - `uuid` string: Optional caller-supplied unique ID for the chat. If omitted the server generates one. The final chat name is `<appId>_<uuid>`.
  - `description` string: Optional short description shown beneath the title in the chat info panel.
  - `type` string: public | group
  - `picture` string: Optional URL for the room avatar. Typically uploaded via `/v1/files/` first; pass the resulting `location` here.
  - `members` string[]: Array of `xmppUsername` strings (`<appId>_<userId>`) to add as initial members. The caller's own JID is implicit and does not need to be listed.

## Response `200`

```
{
  ok: boolean,
}
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: ``` { error: 'Forbidden' } ```
- `404`: Not Found
- `422`: ``` { error: string } ```
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)