---
title: "Create a live event"
method: POST
path: "/live-events"
tags: ["Live Events"]
---

# Create a live event

`POST /live-events`

## Headers

- `channel` string, required
- `organization` string, required

## Request body

- CreateLiveEventInput
  - `title` string, required — Live event title
  - `description` string, required — Live event description
  - `thumbnail` string, required — Path to the image file in cloud storage
  - `orientation` 'PORTRAIT' | 'LANDSCAPE' — Will the video stream have portrait or landscape orientation?
  - `kind` 'PUBLIC' | 'EXCLUSIVE' | 'PAYWALL' | 'PRIVATE' | 'GEOLOCKED' | 'AUTO' — Access level determines who can access this live event.
  - `access` 'AVAILABLE' | 'REDACTED' | 'GEOLOCKED' | 'PUBLIC' — Determines if the access to the event is restricted based on the viewer's geographical location.
  - `scheduledStartAt` string, date-time, required — The date and time when the event is scheduled to take place.
  - `entitlements` string[] — Entitlemetns. A string array of product IDs.
  - `geoFence` GeofenceObject
    - `countryCodes` string[]
    - `type` 'WHITELIST' | 'BLACKLIST'

## Response `201`

---

[API](https://skmtc.net/fanhero/apis/tenant-endpoints.md) · [All operations](https://skmtc.net/fanhero/apis/tenant-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanhero/tenant-endpoints/versions/8e7584c449dc/schema)