Skip to main content

​
✨ Create a Playlist

Creates a new playlist.

​
📤 Request Example

curl -X POST https://betaapi.audiohook.com/v2/companies/:companyUUID/playlists \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "request_headers": [
      { "name": "X-Request-Header", "value": "Header value" }
    ],
    "body": {
      "name": "Example playlist",
      "advertiser_id": "fe95310e-6f6f-4aad-aad6-c18aa7d84ec7",
      "inventory_ids": ["Spotify"],
      "searches": [],
      "type": "streaming",
      "tags": ["example 1"]
    }
  }'

​
🌐 HTTP Request

POST /v2/companies/:companyUUID/playlists

​
🧾 Body Parameters

ParameterRequiredTypeDescription
name✅stringName of the playlist.
advertiser_id✅stringAdvertiser UUID.
inventory_ids✅arrayList of inventory IDs.
searches✅arrayList of query searches.
type✅stringType (podcast, radio, streaming).
tags❌arrayTags to associate.