---
title: "Create Event Room"
method: POST
path: "/api/addon/rooms"
tags: ["gcal-addon"]
---

# Create Event Room

`POST /api/addon/rooms`

Create (or return) the FluenTea room for a calendar event. Idempotent by
gcal_event_id: Calendar may call onCreateFunction more than once.

## Headers

- `authorization` string, nullable

## Request body

- RoomSettings
  - `gcal_event_id` string, required
  - `title` string, nullable
  - `start_iso` string, nullable
  - `language` string, nullable
  - `video_enabled` boolean, nullable
  - `max_participants` integer, nullable
  - `visibility` string, nullable
  - `activity_type` string, nullable
  - `exchange_language` string, nullable
  - `multilingual` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored.md) · [All operations](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fluentea/aurqa-language-learning-platform-refactored/revisions/78f314acd8bf/schema)
