---
title: "Create a chat in a target app (v2, tenant actor)"
method: POST
path: "/v2/apps/{appId}/chats"
tags: ["Chats"]
---

# Create a chat in a target app (v2, tenant actor)

`POST /v2/apps/{appId}/chats`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/apps/{appId}/chats`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

**Auth**: Tenant Actor

Creates a public or group chat in the explicit target app using the app system account as the room owner.
Supports `User JWT` and `B2B Server JWT`.

## Path parameters

- `appId` string, required

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

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `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)