---
title: "Create a Meet room"
method: POST
path: "/meet/rooms"
tags: ["Meet"]
---

# Create a Meet room

`POST /meet/rooms`

## Request

- Base URL: `https://faivelo.com/api/v1`
- URL: `https://faivelo.com/api/v1/meet/rooms`
- Auth: HTTP bearer

Creates a Faivelo Meet video room and returns its join and host URLs. Useful for integrations that schedule meetings (e.g. an ATS creating interview links). Requires scope `meet:write`.

## Request body

- CreateMeetRoomRequest: Request body for creating a Meet room (all fields optional)
  - `title` string
  - `scheduledFor` string, date-time: When the meeting is planned to start
  - `mailboxAddress` string, email: Mailbox to attribute the room to (must be operable by this key/connection)

## Response `200`

Room created

- object
  - `success` boolean
  - `data` MeetRoom: A created Faivelo Meet room
    - `slug` string
    - `url` string: Join URL to share with participants
    - `hostUrl` string: Host URL with moderator controls

## Other responses

- `401`: Missing or invalid API key
- `402`: The account's plan does not include the API (`plan_required`)
- `403`: The key lacks the required scope
- `429`: Rate limit exceeded

---

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