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

# Create a live event

`POST /live-events`

## Request

- Base URL: `https://api.fanheroapi.com`
- URL: `https://api.fanheroapi.com/live-events`
- Auth: API key in header `apiKey`

## 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.dev/fanhero/apis/headless-cms-endpoints.md) - [All operations](https://skmtc.dev/fanhero/apis/headless-cms-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/fanhero/apis/headless-cms-endpoints/revisions/fb8d50c05ee6?raw)