---
title: "Create collection"
method: POST
path: "/v1/collection"
tags: ["Collections"]
---

# Create collection

`POST /v1/collection`

## Request

- Base URL: `https://api.audiodelivery.net`
- URL: `https://api.audiodelivery.net/v1/collection`
- Auth: HTTP bearer

## Request body

- object
  - `title` string, required
  - `creator_id` string, uuid
  - `organization_index` string
  - `metadata` object
  - `theme` ImageColor[]
    - `hex` string
    - `area` number
    - `lightness` number
    - `saturation` number
  - `is_cover_overridable` boolean
  - `is_theme_overridable` boolean
  - `player_color` string
  - `player_subtitle` string

## Response `200`

Collection created.

- object
  - `ok` true, required
  - `api_request_id` string, uuid, required
  - `collection_id` string, uuid
  - `collection` Collection
    - `id` string, uuid
    - `creator_id` string, uuid
    - `organization_index` string
    - `title` string
    - `metadata` object
    - `theme` ImageColor[]
      - `hex` string
      - `area` number
      - `lightness` number
      - `saturation` number
    - `is_cover_overridable` boolean
    - `is_theme_overridable` boolean
    - `player_color` string
    - `player_color_light` string: Derived read-only variant of player_color adjusted to stay legible on a light background.
    - `player_color_dark` string: Derived read-only variant of player_color adjusted to stay legible on a dark background.
    - `player_subtitle` string
  - `collection_cover_upload` UploadHandle
    - `method` 'PUT' | 'POST'
    - `upload_url` string, uri
    - `ttl` integer
    - `expires_at` string, date-time

## Other responses

- `400`: Invalid parameters.
- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/audiodeliverynetwork/apis/audiodn-api.md) · [All operations](https://skmtc.dev/audiodeliverynetwork/apis/audiodn-api/llms.txt) · [OpenAPI document](https://skmtc.dev/audiodeliverynetwork/apis/audiodn-api/revisions/57d355fc6a44?raw)