---
title: "Create an album"
method: POST
path: "/me/albums"
tags: ["Albums\\Essentials"]
---

# Create an album

`POST /me/albums`

This method creates a new album for the specified user.

## Response `201`

The album was created.

## Other responses

- `400` — A parameter is invalid.
- `403` — The supplied token doesn't have the proper scopes, or the authenticated user can't create an album.

## Changes

- **2026-07-13** `ea882e0224a4` — 2 info
  - added the required property `metadata/interactions/add_to` to the response with the `201` status
  - added the required property `share_link` to the response with the `201` status
- **2019-03-29** `d66f7a79837f` — 2 info
  - added the required property `autoplay` to the response with the `201` status
  - added the required property `loop` to the response with the `201` status
- **2019-02-22** `0aaf609c3dbf` — 1 info
  - the request property `description` became optional
- **2019-02-08** `8e9ff8a1caf3` — 6 info
  - added the required property `allow_continuous_play` to the response with the `201` status
  - added the required property `allow_downloads` to the response with the `201` status
  - added the required property `allow_share` to the response with the `201` status
  - added the required property `metadata/interactions/add_custom_thumbnails` to the response with the `201` status
  - …2 more
- **2019-02-01** `ff2c9d773e0b` — 3 info
  - added the required property `embed_brand_color` to the response with the `201` status
  - added the required property `embed_custom_logo` to the response with the `201` status
  - added the required property `hide_vimeo_logo` to the response with the `201` status

[Full history](https://skmtc.dev/vimeo/apis/vimeo-api/changes/me/albums/post.md)

---

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