---
title: "Create live session"
method: POST
path: "/public/create-live-event-session"
tags: ["Live"]
---

# Create live session

`POST /public/create-live-event-session`

Create a new live event session that you can use to go live

Authentication with the "FERMION-API-KEY" header is required to use this endpoint.

Rate limit: Maximum 60 requests in a window of 1m.

## Request body

- object
  - `data` object[], required
    - `data` object, required
      - `eventTitle` string — The title of the event. This will be visible to users inside call
      - `estimatedStartAtIso` string, date-time, required — Estimated start time in ISO format. This is only used as a hint and is not enforced (you may start live event before/after this as well)
      - `shouldUseDrmForViewer` boolean — If passed as true, the HLS playback on viewer side will use DRM protection (widevine and fairplay)
      - `shouldAddEveryoneOnStageByDefault` boolean — If passed as true, then everyone would be added on stage by default. Note that the max number of students on stage (stage limit) is enforced by the plan limit you have with Fermion.
      - `estimatedEventDurationInMinutes` union, required — Estimated duration of the live event in minutes. Must be one of: 15, 30, 45, 60, 90, 120, 180, 240, 300, or 360 minutes
        - 15
        - 30
        - 45
        - 60
        - 90
        - 120
        - 180
        - 240
        - 300
        - 360

## Response `200`

API Response Body

- object[]
  - `output` union, required
    - object
      - `status` 'ok', required
      - `data` object, required
        - `liveEventId` string, required — This is the event ID of the live event.
        - `liveEventSessionId` string, required — This is the session ID of the live event session you must use in your other API calls to modify the session.
    - object
      - `status` 'error', required
      - `errorMessage` string, required

---

[API](https://skmtc.net/fermion/apis/fermion-backend-api.md) · [All operations](https://skmtc.net/fermion/apis/fermion-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fermion/fermion-backend-api/versions/7ce364c8820b/schema)