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

# Create an album

> Create an album record.

Your integration should authenticate its user and restrict album management to that creator. [Library integration](/dev/guides/library).

## JSON body

<ParamField body="title" type="string" required>
  Minimum length: `1`.
</ParamField>

<ParamField body="creator" type="string" required>
  Wallet address for the selected account. Use the same address as the session owner. Minimum length: `10`.
</ParamField>

<ParamField body="description" type="string" />

<ParamField body="cover" type="string" />

<ParamField body="public" type="boolean" default={false} />

## Response (201)

Success.

<ResponseField name="id" type="string" required />

<ResponseField name="title" type="string" required />

<ResponseField name="creator" type="string" required />

<ResponseField name="description" type="string | null" />

<ResponseField name="cover" type="string | null" />

<ResponseField name="public" type="boolean" />

<ResponseField name="created_at" type="string" />

## Errors

Failed JSON responses contain an `error` string. Check the HTTP status before reading a successful result. See [job handling](/dev/guides/jobs) for interrupted or uncertain submissions.

| Status | Meaning |
| - | - |
| `400` | Invalid request. |
| `500` | Request failed. |

<RequestExample>
  ```bash cURL theme={null}
  curl --fail-with-body -X POST "$RAWCHUNKS_API/api/albums" \
    -H "Content-Type: application/json" \
    --data "$(jq -nc --arg user "$USER_ADDRESS" '{
    "title": "Night circuits",
    "creator": $user,
    "public": false
  }')"
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "album-example",
    "title": "Night circuit",
    "creator": "0x1111111111111111111111111111111111111111"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.