---
title: "POST /_twake/app/v1/rooms"
method: POST
path: "/_twake/app/v1/rooms"
tags: ["Application server"]
---

# POST /_twake/app/v1/rooms

`POST /_twake/app/v1/rooms`

Implements https://www.notion.so/Automatic-channels-89ba6f97bc90474ca482a28cf3228d3e

## Request body

- object
  - `ldapFilter` object, required — An object containing keys/values to build a ldap filter
  - `aliasName` string, required — The desired room alias local part. If aliasName is equal to foo the complete room alias will be
  - `name` string — The room name
  - `topic` string — A short message detailing what is currently being discussed in the room.
  - `visibility` 'public' | 'private' — visibility values: * `public` - The room will be shown in the published room list * `private` - Hide the room from the published room list

## Response `200`

Success

- object[]
  - `errcode` string
  - `error` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict
- `500` — Internal server error

## Changes

- **2024-01-09** `c7a6d3a400a7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation/changes/_twake/app/v1/rooms/post.md)

---

[API](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation.md) · [All operations](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation/revisions/ecce38b281bc?raw)