---
title: "List playlists"
method: GET
path: "/api/profiles/{profile_id}/youtube/playlists"
tags: ["YouTube"]
---

# List playlists

`GET /api/profiles/{profile_id}/youtube/playlists`

## Request

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

Lists the playlists on the connected YouTube channel, up to 50 per page. Each playlist's id is the playlist_id you can publish a video into.

## Path parameters

- `profile_id` string, required

## Query parameters

- `page_token` string
- `profile_group_id` string

## Response `200`

A page of playlists

- object
  - `data` 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
  - `next_page_token` string, nullable: null on the last page

## 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)