---
title: "Create Room With Metadata"
method: POST
path: "/api/livekit/create"
tags: ["livekit"]
---

# Create Room With Metadata

`POST /api/livekit/create`

Create a new LiveKit room with the provided room_id and generate an access token.

This endpoint:
1. Creates a new LiveKit room using the provided room_id as the room name
2. Generates an access token for the participant
3. Returns room details and the access token

## Headers

- `x-user-id` string, nullable

## Request body

- CreateRoomRequest
  - `room_id` string, required — Room ID to create the LiveKit room
  - `opening_message` string, nullable — Optional text the voice agent should speak verbatim as its first utterance.
  - `supports_voice_idle_check` boolean — True when the client supports the voice_control idle-check flow (receives 'idle_check' and replies 'idle_active'). Older builds omit it.

## Response `201`

Successful Response

- RoomResponse
  - `room` object, required
  - `access_token` string, required
  - `url` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/usecreed/apis/creed-api.md) · [All operations](https://skmtc.net/usecreed/apis/creed-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usecreed/creed-api/versions/523833f9e819/schema)