---
title: "Create a watchlist playlist"
method: POST
path: "/v2/sites/{site_id}/playlists/watchlist_playlist/"
tags: ["playlists"]
---

# Create a watchlist playlist

`POST /v2/sites/{site_id}/playlists/watchlist_playlist/`

## Path parameters

- `site_id` string, required — Unique identifier for a resource

## Request body

- object
  - `metadata` PlaylistMetadata
    - `title` string — Title of the playlist. When using JWX's HTML5 player, the playlist title is displayed in the overlay. A maximum of 256 characters is permitted.
    - `description` string — Description of the playlist A maximum of 7500 characters is permitted.
    - `author` string — Author of the playlist A maximum of 256 characters is permitted.
    - `link` string — URL to be associated with the playlist A maximum of 2048 characters is permitted.
    - `custom_params` CustomParamSchema — User-generated key-value pairs When defining `custom_params`, include all custom parameters that should be associated with the target resource. When updating existing `custom_params`, include all `custom_params` keys with their updated values. Any `custom_params` key-value pair not included within the updated `custom_params` in the request body is [deleted](https://docs.jwplayer.com/platform/docs/stream-faq-how-can-i-delete-a-custom-parameter).

## Response `201`

Resource successfully created

- WatchlistPlaylistResourceRead — Resource for managing a watchlist playlist
  - `schema` string
  - `id` string — Unique identifier for a resource
  - `created` string — Date and time at which the resource was created
  - `last_modified` string — Date and time at which the resource was most recently modified
  - `type` string — Name of the type of resource.
  - `relationships` object — Ancilliary resources associated to the primary resource being read
  - `metadata` PlaylistMetadata
    - `title` string — Title of the playlist. When using JWX's HTML5 player, the playlist title is displayed in the overlay. A maximum of 256 characters is permitted.
    - `description` string — Description of the playlist A maximum of 7500 characters is permitted.
    - `author` string — Author of the playlist A maximum of 256 characters is permitted.
    - `link` string — URL to be associated with the playlist A maximum of 2048 characters is permitted.
    - `custom_params` CustomParamSchema — User-generated key-value pairs When defining `custom_params`, include all custom parameters that should be associated with the target resource. When updating existing `custom_params`, include all `custom_params` keys with their updated values. Any `custom_params` key-value pair not included within the updated `custom_params` in the request body is [deleted](https://docs.jwplayer.com/platform/docs/stream-faq-how-can-i-delete-a-custom-parameter).

## Other responses

- `400` — Bad Request The request either lacks certain attributes or contains malformed/invalid attributes.

---

[API](https://skmtc.net/jwplayer/apis/management-api-v2.md) · [All operations](https://skmtc.net/jwplayer/apis/management-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jwplayer/management-api-v2/versions/180db7cada27/schema)