Create a playlist
Create a new private playlist for the authenticated user. You can optionally seed it with tracks, stems, or sound effects in the same call.
POST/api/v4/me/playlists/
Request body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Playlist title. |
description | string | No | Free-text description. |
tracks | array of UUIDs | No | Track IDs to add on creation. |
stems | array of UUIDs | No | Stem IDs to add on creation. |
soundfxs | array of UUIDs | No | Sound effect IDs to add on creation. |
Example request
curl https://api.slipstreammusic.com/api/v4/me/playlists/ \
-X POST \
-H "Authorization: Bearer $PARTNER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Late Night",
"description": "Reflective jazz under 120 BPM",
"tracks": [
"8a4b2c1d-9e7f-4a6b-b3c2-1f8d4e5a7c6b",
"1f3c4d5e-6a7b-8c9d-0e1f-2a3b4c5d6e7f"
]
}'Response — 201 Created
{
"success": true,
"playlist": {
"id": "9b5c3d2e-0a8e-4b7c-c4d3-2g9e5f6b8d7c",
"name": "Late Night",
"slug": "late-night",
"description": "Reflective jazz under 120 BPM",
"owner": { "id": "...", "username": "...", "name": "..." },
"permission": "owner",
"playlist_type": "user",
"tracks": 2,
"duration": 280,
"url": "/playlists/late-night",
"collaborators": []
},
"skipped": 0,
"duplicated": 0
}| Field | Description |
|---|---|
playlist | The new playlist. See The Playlist object. |
skipped | Items rejected because the user can't add them (e.g., restricted content not in their tier). |
duplicated | Duplicate UUIDs in your input that were collapsed. |
The new playlist is private by default. Sharing and can_edit collaborators are managed through separate endpoints.