---
title: "Create album"
method: POST
path: "/boxes/{boxId}/media/albums"
tags: ["Media"]
---

# Create album

`POST /boxes/{boxId}/media/albums`

Create a new album with media files

## Path parameters

- `boxId` string, required

## Response `201`

Album created successfully

- Album — Album representation
  - `name` string, required — Name of the album
  - `path` string, required — Full path to the album in the box
  - `lastModified` string, date-time, required — Last modified time of the album
  - `mediaCount` number, required — Number of media files in the album

---

[API](https://skmtc.dev/babelcloud/apis/gbox-open-api.md) · [All operations](https://skmtc.dev/babelcloud/apis/gbox-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/babelcloud/gbox-open-api/revisions/d655577fa915/schema)