> ## Documentation Index
> Fetch the complete documentation index at: https://developer.audiohook.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create playlist

## ✨ Create a Playlist

Creates a new playlist.

### 📤 Request Example

```bash theme={null}
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

```http theme={null}
POST /v2/companies/:companyUUID/playlists
```

### 🧾 Body Parameters

| Parameter      | Required | Type   | Description                       |
| -------------- | -------- | ------ | --------------------------------- |
| name           | ✅        | string | Name of the playlist.             |
| advertiser\_id | ✅        | string | Advertiser UUID.                  |
| inventory\_ids | ✅        | array  | List of inventory IDs.            |
| searches       | ✅        | array  | List of query searches.           |
| type           | ✅        | string | Type (podcast, radio, streaming). |
| tags           | ❌        | array  | Tags to associate.                |

***