---
title: "Plan a conference"
method: POST
path: "/1/kmeet/rooms"
tags: ["Plan a conference"]
---

# Plan a conference

`POST /1/kmeet/rooms`

This endpoint allows you to plan a conference with predefined settings. It will add an event on your Infomaniak Calendar with the meeting url.
 If you just want to create a room you don't need any API calls, you can build a conference URL by adding an unique identifier to your kMeet instance url (eg: kmeet.infomaniak.com/${MY_VERY_SECRET_CONFERENCE_ID})

## Request body

- Afdc46e4PlannedConference
  - `calendar_id` integer, required — The unique identifier (ID) of the Infomaniak Calendar where you want to plan the meeting. Make a GET request on https://calendar.infomaniak.com/api/pim/calendar
  - `starting_at` string, required
  - `ending_at` string, required — Room settings can be deleted if this date expires. This field will be updated if event dates change in Infomaniak Calendar.
  - `timezone` string, required
  - `hostname` string, required — Needed for rebuilding room url
  - `title` string, required
  - `description` string
  - `attendees` Afdc46e4CalendarEventAttendees[]
    - `address` string, required
    - `organizer` boolean
    - `state` 'NEEDS-ACTION' | 'ACCEPTED' | 'DECLINED' | 'TENTATIVE' | 'DELEGATED', required
    - `name` string
  - `options` Afdc46e4ConferenceOptions[], required
    - `subject` string, required
    - `start_audio_muted` boolean, required
    - `enable_moderator_video` boolean, required
    - `start_audio_only` boolean, required
    - `lobby_enabled` boolean, required
    - `password_enabled` boolean, required
    - `password` string — Required if password_enabled is true (never displayed)
    - `e2ee_enabled` boolean, required

## Response `200`

Default Response

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` Afdc46e4PlannedConferenceReturn
    - `id` integer
    - `name` string
    - `code` string
    - `user_id` integer
    - `event_id` integer
    - `created_at` string
    - `updated_at` string
    - `ending_at` string, required — Room settings can be deleted if this date expires. This field will be updated if event dates change in Infomaniak Calendar.
    - `hostname` string, required — Needed for rebuilding room url
    - `options` Afdc46e4ConferenceOptionsReturn[], required
      - `subject` string, required
      - `start_audio_muted` boolean, required
      - `enable_recording` boolean, required
      - `drive_id` integer — Required if enable_recording is true
      - `enable_moderator_video` boolean, required
      - `start_audio_only` boolean, required
      - `lobby_enabled` boolean, required
      - `password_enabled` boolean, required
      - `e2ee_enabled` boolean, required

## Other responses

- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)