---
title: "Create playlist"
method: POST
path: "/api/profiles/{profile_id}/youtube/create_playlist"
tags: ["YouTube"]
---

# Create playlist

`POST /api/profiles/{profile_id}/youtube/create_playlist`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/profiles/{profile_id}/youtube/create_playlist`
- Auth: HTTP bearer

Creates a playlist on the connected YouTube channel. Costs 50 units of the channel's YouTube Data API quota.

## Path parameters

- `profile_id` string, required

## Query parameters

- `profile_group_id` string

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `title` string, required: Playlist title
  - `description` string: Playlist description
  - `privacy_status` 'public' | 'unlisted' | 'private'

## Response `200`

The new playlist

- YouTubePlaylist
  - `id` string: YouTube playlist ID
  - `title` string
  - `description` string
  - `privacy_status` 'public' | 'unlisted' | 'private'
  - `item_count` integer: Number of videos in the playlist
  - `thumbnail_url` string, nullable
  - `published_at` string, date-time

## Other responses

- `400`: Missing required parameters.
- `401`: Invalid, missing, or insufficient API key permissions.
- `403`: The connection lacks permission to manage playlists; reconnect the profile
- `404`: Resource does not exist or is not accessible.
- `422`: Validation failed.
- `429`: Posting rate limit reached.
- `502`: YouTube could not be reached

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)