---
title: "Create chat"
method: POST
path: "/v1/chats"
tags: ["Chats"]
deprecated: true
---

# Create chat

`POST /v1/chats`

## Request

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

> **Deprecated.**

**Deprecated**: use `/v2/chats` instead.

**Auth**: User JWT

Create chat

## 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,
}
```

- ChatCreateResponse
  - `result` ChatRecord, required
    - `_id` string, nullable
    - `name` string
    - `title` string, nullable
    - `description` string, nullable
    - `type` string, nullable
    - `picture` string, nullable
    - `appId` string, nullable
    - `createdBy` string, nullable
    - `e2ee` boolean, nullable
    - `reported` boolean, nullable
    - `members` UserPublic[], nullable
      - `_id` string
      - `uuid` string, nullable
      - `xmppUsername` string
      - `email` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `username` string, nullable
      - `profileImage` string, nullable
      - `profilePicture` string, nullable
      - `description` string, nullable
      - `tags` string[], nullable
    - `createdAt` string, nullable
    - `updatedAt` string, nullable

## 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)