Reference
Release NoteHelpcenterStatus PageContact Us
  1. Dailymotion API v2
  2. Livestream

Create a livestream for a profile

post
https://api.dailymotion.com/v2/profiles//livestreams

Create a livestream on this profile. Required body fields are
title, visibility, category, and is_for_kids.
Returns 201 with the new resource.
Requires live.manage
scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
📘

You are reading API v2 documentation

Still using the Legacy API? Access the Legacy API documentation.



Path Params
string
required

Parent resource ID

Body Params
string
required
length between 1 and 255
(?:\S+\s*)+

Title of the livestream. Cannot be blank. Maximum 255 characters.

Required when creating a livestream. Must be at least 1 characters. Must be at most 255 characters. Must match pattern: (?:\S+\s*)+.

length ≤ 3000

Optional description of the livestream. Supports HTML.
Maximum 3000 characters. Leading and trailing whitespace is trimmed. Must be at most 3000 characters. Accepts HTML content.

^[a-zA-Z]{2}$

ISO 639-1 language code (e.g. en, fr). Must match pattern: ^[a-zA-Z]{2}$.

string
enum
required

Content category used for discovery and reporting.

Required when creating a livestream.

^[a-zA-Z]{2}$

ISO 3166-1 alpha-2 country code (e.g. US, FR). Must match pattern: ^[a-zA-Z]{2}$.

string
enum
required

Who can watch the livestream.

Values: public, private, or password.
Required when creating a livestream.

Allowed:
boolean
required

Whether the livestream is made for kids (COPPA). Required on create. Strict type checking (no coercion).

boolean
Defaults to false

Whether the livestream is explicit.

Warning This flag cannot be removed once set. Strict type checking (no coercion).

boolean
Defaults to false

Whether the livestream is exclusive to Dailymotion. Strict type checking (no coercion).

boolean
Defaults to false

Whether the livestream content was altered with AI. Strict type checking (no coercion).

boolean
Defaults to false

Whether the livestream discloses a paid partnership. Strict type checking (no coercion).

boolean
Defaults to true

Whether comments are enabled on this livestream. Strict type checking (no coercion).

length between 1 and 32

Password for the livestream when visibility is password. Must be at least 1 characters. Must be at most 32 characters. Required when visibility is password. Only allowed when visibility is password.

ISO 8601 timestamp when the stream started (or is scheduled to start).

ISO 8601 timestamp when the stream ended (or is scheduled to end).

recording
object

Recording configuration and status.

geo_restriction
object

Geo-restriction settings. Optional at creation; when provided, both
mode and countries must be supplied.

embedding
object

Embedding settings for the live player.

Responses

Updated about 1 month ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago

Did this page help you?