---
title: "Creates a new room."
method: POST
path: "/rooms"
tags: ["Rooms"]
---

# Creates a new room.

`POST /rooms`

## Query parameters

- `api-version` string, required

## Headers

- `Repeatability-Request-ID` string, uuid
- `Repeatability-First-Sent` string, date-time-rfc1123

## Request body

- CreateRoomRequest — Request payload for creating new room.
  - `validFrom` string, date-time — The timestamp from when the room is open for joining. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`. The default value is the current date time.
  - `validUntil` string, date-time — The timestamp from when the room can no longer be joined. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`. The default value is the current date time plus 180 days.
  - `pstnDialOutEnabled` boolean — Set this flag to true if, at the time of the call, dial out to a PSTN number is enabled in a particular room. By default, this flag is set to false.
  - `participants` object — (Optional) Participants to be invited to the room.

## Response `201`

Request successful. The action returns a new room.

- RoomModel — The meeting room.
  - `id` string, required — Unique identifier of a room. This id is server generated.
  - `createdAt` string, date-time, required — The timestamp when the room was created at the server. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `validFrom` string, date-time, required — The timestamp from when the room is open for joining. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `validUntil` string, date-time, required — The timestamp from when the room can no longer be joined. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `pstnDialOutEnabled` boolean, required — Set this flag to true if, at the time of the call, dial out to a PSTN number is enabled in a particular room. By default, this flag is set to false.

## Other responses

- `default` — Error response

## Changes

- **2026-07-13** (2022-02-01-preview) `6a1caa3099fb` — 1 info
  - api operation id `Rooms_CreateRoom` removed and replaced with `Rooms_Create`

[Change history](https://skmtc.dev/azure/apis/communication-rooms/changes/rooms/post.md)

---

[API](https://skmtc.dev/azure/apis/communication-rooms.md) · [All operations](https://skmtc.dev/azure/apis/communication-rooms/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-rooms/revisions/a04e78631a73/schema)