Connect

Create YouTube playlist

Changed on

Creates an empty playlist on the connected YouTube channel. Requires a title; privacy defaults to private.

Returns the same playlist shape as the list endpoint. Pass the returned playlist.id as platformSpecificData.playlistId when publishing a video. Does not change the account's default playlist.

Requirements and cost

  • Requires the youtube or youtube.force-ssl OAuth scope.
  • Costs 50 YouTube quota units.

Retries

This operation is not idempotent and is not automatically retried. Repeating a request can create another playlist, including after a timeout. List playlists before retrying an ambiguous failure.

Official series

Official series settings are not exposed by YouTube's public API and must be enabled manually in YouTube's desktop playlist settings.

post/v1/accounts/{accountId}/youtube-playlists

Request

Path parameters

accountIdstring required

Request body

titlestring required

Playlist title. Leading and trailing whitespace is removed.

descriptionstring

Optional playlist description.

privacy'private' | 'public' | 'unlisted'

Response

Playlist created

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status