---
title: "Create Room"
method: POST
path: "/rooms"
tags: ["room"]
---

# Create Room

`POST /rooms`

Create a new room

## Request body

- CreateRoomRequest — Request format to create a new room
  - `name` string, required — Human-readable name of the room
  - `type` 'open' | 'public' | 'private', required — Room can have three different type * `open` - anyone who obtain this room url can join and replay the meet. * `public` - any member who haved joined in same worksapce can join and replay the meet. * `private` - only invited workspace user can join and replay the meet.
  - `record` boolean — All meeting will be recorded
  - `max_meeting_seconds` integer — Determines the maximum meeting time in seconds. Once this time has elapsed, the meeting room will be automatically terminated. The 'meeting time' refers to the duration during which two or more participants are connected. If a `max_meeting_seconds` is set, the timer UI will display the remaining meeting time, rather than the elapsed time.
  - `members` RoomMember[] — Specify inviting user_id and type
    - `user_id` string, required — `user_id` of the user in application (workspace) scope
    - `type` 'guest' | 'host' | 'monitor', required — Type of user in this room - guest: The user is guest. - host: The user is host. This user has administrator privileges. - monitor: The user is observer. Can watch the meeting, but can not join.
    - `name` string — Display name of the user in the meeting room
  - `webhook` object
    - `url` string, required — an URL to which the Pagecall server will send the webhook
    - `headers` object — Headers to include when sending the webhook, which can be useful when authentication is required.

## Response `200`

Successful operation

- object
  - `room` Room — Information about room
    - `id` string, required — ID of the room
    - `application_id` string — ID of the workspace
    - `type` 'open' | 'public' | 'private', required — Room can have three different type * `open` - anyone who obtain this room url can join and replay the meet. * `public` - any member who haved joined in same worksapce can join and replay the meet. * `private` - only invited workspace user can join and replay the meet.
    - `created_user_id` string — *[Deprecated]* ID of the user who create this room
    - `name` string, required — Human readable name of the room
    - `thumbnail_url` string — Generated thumbnail for this room
    - `last_thumbnail_updated_at` string, date-time — *[Deprecated]* Last update time of generated thumbnail
    - `room_template_id` string — *[Deprecated]* **Use `layout` instead.** ID of the room template used by this room
    - `layout` string — How the room looks
    - `record` boolean — Whether this room is recorded or not.
    - `meeting_time` integer — Total meeting time in seconds
    - `is_terminated` boolean — *[Deprecated]* **Use `terminated_at` instead.** Whether this room is terminated or not. If true, not available to join the room
    - `is_ephemeral` boolean — *[Deprecated]* Whether this room is for temporary or not. If true and all the members of this room leave, the room will be closed
    - `is_recurring` boolean — *[Deprecated]* Whether this meeting occurs regularly or not. If true, it will be reopened according to a predefined schedule.
    - `started_at` string, date-time — The meeting is started at specified time format
    - `terminated_at` string, date-time — The room is terminated at specified time format
    - `updated_at` string, date-time — The room settings are changed at specified time format
    - `created_at` string, date-time — The room is created at specified time format
  - `paging` Paging — Details of pagination used for current responses.
    - `limit` number, required
    - `offset` number, required
    - `total` number, required

## Other responses

- `400` — Invalid Parameters Supplied or Unauthenticated or Unauthorized
- `500` — Validation exception

---

[API](https://skmtc.net/pplink/apis/pagecall-public-api-openapi-3-0.md) · [All operations](https://skmtc.net/pplink/apis/pagecall-public-api-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pplink/pagecall-public-api-openapi-3-0/revisions/c6a9d7e46d2a/schema)