---
title: "Changes to Create an album"
method: POST
path: "/users/{user_id}/albums"
---

# Changes to Create an album

`POST /users/{user_id}/albums`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 13 revisions.

- **2026-07-13** `ea882e0224a4`: 2 info
- **2019-03-29** `d66f7a79837f`: 2 info
- **2019-02-22** `0aaf609c3dbf`: 1 info
- **2019-02-08** `8e9ff8a1caf3`: 6 info
- **2019-02-01** `ff2c9d773e0b`: 3 info
- **2019-01-11** `89b756668a1e`: 3 info
- **2018-12-05** `26f856a94041`: 17 breaking

## 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
  - added the required property `web_brand_color` to the response with the `201` status
  - added the required property `web_custom_logo` to the response with the `201` status
- **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
- **2019-01-11** `89b756668a1e`: 3 info
  - added the required property `domain` to the response with the `201` status
  - added the required property `url` to the response with the `201` status
  - added the required property `use_custom_domain` to the response with the `201` status
- **2018-12-05** `26f856a94041`: 17 breaking
  - the request property `description` became required
  - removed the required property `allow_continuous_play` from the response with the `201` status
  - removed the required property `allow_downloads` from the response with the `201` status
  - removed the required property `allow_share` from the response with the `201` status
  - removed the required property `autoplay` from the response with the `201` status
  - removed the required property `domain` from the response with the `201` status
  - removed the required property `embed_brand_color` from the response with the `201` status
  - removed the required property `embed_custom_logo` from the response with the `201` status
  - removed the required property `hide_vimeo_logo` from the response with the `201` status
  - removed the required property `loop` from the response with the `201` status
  - removed the required property `metadata/interactions/add_custom_thumbnails` from the response with the `201` status
  - removed the required property `metadata/interactions/add_to` from the response with the `201` status
  - removed the required property `share_link` from the response with the `201` status
  - removed the required property `url` from the response with the `201` status
  - removed the required property `use_custom_domain` from the response with the `201` status
  - removed the required property `web_brand_color` from the response with the `201` status
  - removed the required property `web_custom_logo` from the response with the `201` status

---

[Operation](https://skmtc.dev/vimeo/apis/vimeo-api/docs/users/:user_id/albums/post.md) - [API](https://skmtc.dev/vimeo/apis/vimeo-api.md) - [Page](https://skmtc.dev/vimeo/apis/vimeo-api/changes/users/:user_id/albums/post)