Playlists
Create a playlist
Creates a new playlist. status: published sets active: true; status: draft sets active: false. Send slug + custom_slug: true to pin a
permanent slug; without it, the slug is generated from title when
blank and is kept on later title changes. After creation, Lighthouse and compliance scans are queued
automatically. With lang, the translatable fields (title,
description) are written for that locale; omitting lang writes the
default locale.
POST
/
api
/
v202604
/
company
/
playlists
Create a playlist
curl --request POST \
--url https://api.fluid.app/api/v202604/company/playlists \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"library": {
"title": "Primex Wellness Playlist",
"description": "A curated collection for Primex members.",
"status": "published",
"kind": "manual",
"country_isos": [
"GB",
"US"
]
}
}
'import requests
url = "https://api.fluid.app/api/v202604/company/playlists"
payload = { "library": {
"title": "Primex Wellness Playlist",
"description": "A curated collection for Primex members.",
"status": "published",
"kind": "manual",
"country_isos": ["GB", "US"]
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
library: {
title: 'Primex Wellness Playlist',
description: 'A curated collection for Primex members.',
status: 'published',
kind: 'manual',
country_isos: ['GB', 'US']
}
})
};
fetch('https://api.fluid.app/api/v202604/company/playlists', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/company/playlists",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'library' => [
'title' => 'Primex Wellness Playlist',
'description' => 'A curated collection for Primex members.',
'status' => 'published',
'kind' => 'manual',
'country_isos' => [
'GB',
'US'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/company/playlists"
payload := strings.NewReader("{\n \"library\": {\n \"title\": \"Primex Wellness Playlist\",\n \"description\": \"A curated collection for Primex members.\",\n \"status\": \"published\",\n \"kind\": \"manual\",\n \"country_isos\": [\n \"GB\",\n \"US\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/v202604/company/playlists")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"library\": {\n \"title\": \"Primex Wellness Playlist\",\n \"description\": \"A curated collection for Primex members.\",\n \"status\": \"published\",\n \"kind\": \"manual\",\n \"country_isos\": [\n \"GB\",\n \"US\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/company/playlists")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"library\": {\n \"title\": \"Primex Wellness Playlist\",\n \"description\": \"A curated collection for Primex members.\",\n \"status\": \"published\",\n \"kind\": \"manual\",\n \"country_isos\": [\n \"GB\",\n \"US\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"status": 201,
"meta": {
"request_id": "7f3c9a1e-52d4-4b8e-9c61-2a8e4f0d7b35",
"timestamp": "2026-09-22T14:10:05Z"
},
"playlist": {
"id": 6052,
"slug": "primex-wellness-playlist",
"title": "Primex Wellness Playlist",
"description": "A curated collection for Primex members.",
"image_url": "https://cdn.fluid.app/dunder-mifflin/playlists/primex-wellness-playlist.png",
"canonical_url": "https://shop.dundermifflin.com/home/libraries/primex-wellness-playlist",
"images": {
"thumb": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/dunder-mifflin/playlists/primex-wellness-playlist.png",
"width": 200
},
"medium": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/dunder-mifflin/playlists/primex-wellness-playlist.png",
"width": 600
},
"large": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/dunder-mifflin/playlists/primex-wellness-playlist.png",
"width": 1200
}
},
"active": true,
"status": "published",
"publish_at": null,
"created_at": "2026-09-22T14:10:05Z",
"updated_at": "2026-09-22T14:10:05Z",
"seo": {
"title": "Primex Wellness Playlist",
"description": "A curated collection for Primex members.",
"image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/dunder-mifflin/playlists/primex-wellness-playlist.png",
"indexable": true,
"id": null
},
"metafields": [],
"languages": [
"en"
],
"kind": "manual",
"countries": [
"GB",
"US"
],
"total_items_count": 0,
"library_items": [],
"custom_slug": false,
"owner": null
}
}{
"message": "Invalid credentials."
}{
"error": "Not authorized."
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 25,
"prev_cursor": "<string>",
"next_cursor": "<string>"
}
}
}Authorizations
Bearer token authentication. Accepts company-admin tokens with
storefront.view for read operations and storefront.update
for writes and scan triggers (legacy per-resource grants like
categories.update / products.view / etc. are still accepted
during the migration), required on every company operation.
Storefront public operations under /api/v202604/{resource} and
/api/v202604/{resource}/{slug} are unauthenticated
(security: []).
Query Parameters
Response locale. ISO code (e.g. fr, de). When omitted,
responds in the company's default locale. On reads an
unsupported or unknown locale is ignored — the response comes
back in the default locale, never a 422. Any translated field
with no value in the requested locale falls back to its en
value.
Example:
"fr"
Body
application/json
The wrapper key is library (the resource's legacy
name), while the URL resource is playlists — this mismatch is
intentional, not a typo. The write payload nests under library;
with additionalProperties: false a { playlist: ... } body is
rejected.
Show child attributes
Show child attributes
Response
Playlist created.
Shared success envelope for list / show / create / update
responses: the resource payload is returned alongside a top-level
integer status and meta. Composed onto each resource response
via allOf.
Example:
200
Response metadata included on every successful response body.
request_id and timestamp are always present; list endpoints
also add pagination.
Show child attributes
Show child attributes
Authenticated (company-surface) Playlist read shape: the public
PlaylistBase plus custom_slug and owner, admin metadata never
rendered on the public surface.
Show child attributes
Show child attributes
⌘I
Create a playlist
curl --request POST \
--url https://api.fluid.app/api/v202604/company/playlists \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"library": {
"title": "Primex Wellness Playlist",
"description": "A curated collection for Primex members.",
"status": "published",
"kind": "manual",
"country_isos": [
"GB",
"US"
]
}
}
'import requests
url = "https://api.fluid.app/api/v202604/company/playlists"
payload = { "library": {
"title": "Primex Wellness Playlist",
"description": "A curated collection for Primex members.",
"status": "published",
"kind": "manual",
"country_isos": ["GB", "US"]
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
library: {
title: 'Primex Wellness Playlist',
description: 'A curated collection for Primex members.',
status: 'published',
kind: 'manual',
country_isos: ['GB', 'US']
}
})
};
fetch('https://api.fluid.app/api/v202604/company/playlists', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/company/playlists",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'library' => [
'title' => 'Primex Wellness Playlist',
'description' => 'A curated collection for Primex members.',
'status' => 'published',
'kind' => 'manual',
'country_isos' => [
'GB',
'US'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/company/playlists"
payload := strings.NewReader("{\n \"library\": {\n \"title\": \"Primex Wellness Playlist\",\n \"description\": \"A curated collection for Primex members.\",\n \"status\": \"published\",\n \"kind\": \"manual\",\n \"country_isos\": [\n \"GB\",\n \"US\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/v202604/company/playlists")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"library\": {\n \"title\": \"Primex Wellness Playlist\",\n \"description\": \"A curated collection for Primex members.\",\n \"status\": \"published\",\n \"kind\": \"manual\",\n \"country_isos\": [\n \"GB\",\n \"US\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/company/playlists")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"library\": {\n \"title\": \"Primex Wellness Playlist\",\n \"description\": \"A curated collection for Primex members.\",\n \"status\": \"published\",\n \"kind\": \"manual\",\n \"country_isos\": [\n \"GB\",\n \"US\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"status": 201,
"meta": {
"request_id": "7f3c9a1e-52d4-4b8e-9c61-2a8e4f0d7b35",
"timestamp": "2026-09-22T14:10:05Z"
},
"playlist": {
"id": 6052,
"slug": "primex-wellness-playlist",
"title": "Primex Wellness Playlist",
"description": "A curated collection for Primex members.",
"image_url": "https://cdn.fluid.app/dunder-mifflin/playlists/primex-wellness-playlist.png",
"canonical_url": "https://shop.dundermifflin.com/home/libraries/primex-wellness-playlist",
"images": {
"thumb": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/dunder-mifflin/playlists/primex-wellness-playlist.png",
"width": 200
},
"medium": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/dunder-mifflin/playlists/primex-wellness-playlist.png",
"width": 600
},
"large": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/dunder-mifflin/playlists/primex-wellness-playlist.png",
"width": 1200
}
},
"active": true,
"status": "published",
"publish_at": null,
"created_at": "2026-09-22T14:10:05Z",
"updated_at": "2026-09-22T14:10:05Z",
"seo": {
"title": "Primex Wellness Playlist",
"description": "A curated collection for Primex members.",
"image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/dunder-mifflin/playlists/primex-wellness-playlist.png",
"indexable": true,
"id": null
},
"metafields": [],
"languages": [
"en"
],
"kind": "manual",
"countries": [
"GB",
"US"
],
"total_items_count": 0,
"library_items": [],
"custom_slug": false,
"owner": null
}
}{
"message": "Invalid credentials."
}{
"error": "Not authorized."
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 25,
"prev_cursor": "<string>",
"next_cursor": "<string>"
}
}
}