LiveCuepoints: insert

This method has been deprecated and replaced by the liveBroadcasts.cuepoint method.

Inserts a cuepoint into a live broadcast. Currently, requests to this method must be authorized by an account associated with a YouTube Content Owner.


HTTP request



This request requires authorization with at least one of the following scopes (read more about authentication and authorization).



The following table lists the parameters that this query supports. All of the parameters listed are query parameters.

Required parameters
channelId string
The channelId parameter identifies the channel that owns the broadcast into which the cuepoint is being inserted.
onBehalfOfContentOwner string
The onBehalfOfContentOwner parameter identifies the content owner that the user is acting on behalf of.

Request body

Provide a liveCuepoint resource in the request body. For that resource:

  • You must specify a value for these properties:

    • broadcastId
    • settings.cueType

  • You can set values for these properties:

    • settings.offsetTimeMs
    • settings.walltime
    • settings.durationSecs


If successful, this method returns a liveCuepoint resource in the response body.


The following table identifies error messages that the API could return in response to a call to this method. Please see the error message documentation for more detail.

Error type Error detail Description
invalidValue (400) conflictingTimeFields Only one of offsetTimeMs and walltime may be specified.