---
title: "Create a new room"
method: POST
path: "/api/rooms"
tags: ["rooms"]
---

# Create a new room

`POST /api/rooms`

## Request

- Base URL: `https://useclippy.cc`
- URL: `https://useclippy.cc/api/rooms`
- Auth: none declared

Generates a fresh 6-character room code and an owner token. The
owner token is shown ONCE in the response; the client should save
it locally if they want to manage the room password later.

## Response `200`

Room created

- object
  - `code` string, required
  - `owner_token` string, required

---

[API](https://skmtc.dev/useclippy/apis/clippy-api.md) · [All operations](https://skmtc.dev/useclippy/apis/clippy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useclippy/apis/clippy-api/revisions/9635a19d0ab8?raw)