---
title: "Create a Video Alert"
method: POST
path: "/video-alerts/"
---

# Create a Video Alert

`POST /video-alerts/`

## Request

- Base URL: `https://cf-blast.livelikecdn.com/api/v1`
- URL: `https://cf-blast.livelikecdn.com/api/v1/video-alerts/`
- Auth: none required

## Request body

- object
  - `title` string: The Video Alert title
  - `text` string: The Video Alert text
  - `video_url` string, required: The URL to the video file
  - `link_url` string: The Link URL
  - `link_label` string: The text label for the Link URL
  - `playback_time_ms` integer: Video playback time in milliseconds
  - `widget_attributes` object[]
    - `key` string, required
    - `value` string, required
  - `custom_data` string
  - `sponsor_ids` string[]: Links the ```sponsors``` with this Video Alert. Note that only valid sponsor_ids will be linked to a Video Alert.

## Response `201`

201

- object
  - `client_id` string
  - `created_at` string
  - `created_by` object
    - `id` string
    - `image_url` unknown
    - `name` unknown
  - `custom_data` unknown
  - `engagement_count` unknown
  - `engagement_percent` unknown
  - `id` string
  - `impression_count` integer
  - `impression_url` string
  - `interaction_url` string
  - `interactive_until` unknown
  - `kind` string
  - `link_label` string
  - `link_url` string
  - `program_date_time` unknown
  - `program_id` string
  - `publish_delay` string
  - `published_at` string
  - `reactions` unknown[]
    - unknown
  - `rewards_url` unknown
  - `schedule_url` string
  - `scheduled_at` string
  - `sponsors` unknown[]
    - unknown
  - `status` string
  - `subscribe_channel` string
  - `text` string
  - `timeout` string
  - `title` string
  - `translatable_fields` string[]
  - `translations` object
  - `unique_impression_count` integer
  - `playback_time_ms` unknown
  - `url` string
  - `video_url` string
  - `widget_interactions_url_template` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `3e5529c26ce4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/livelike/apis/engagement-suite/changes/video-alerts/post.md)

---

[API](https://skmtc.dev/livelike/apis/engagement-suite.md) - [All operations](https://skmtc.dev/livelike/apis/engagement-suite/llms.txt) - [OpenAPI document](https://skmtc.dev/livelike/apis/engagement-suite/revisions/3e5529c26ce4?raw)