---
title: "Add a custom uploaded thumbnail"
method: POST
path: "/users/{user_id}/albums/{album_id}/custom_thumbnails"
tags: ["Albums\\Custom album thumbnails"]
---

# Add a custom uploaded thumbnail

`POST /users/{user_id}/albums/{album_id}/custom_thumbnails`

This method adds an image file as a custom thumbnail to the specified album. For information on how to upload the thumbnail, see our
[Working with Thumbnail Uploads](https://developer.vimeo.com/api/upload/thumbnails) guide, and follow the same steps.

## Path parameters

- `album_id` number, required
- `user_id` number, required

## Response `201`

The custom thumbnail was added to the album.

## Other responses

- `403` — The authenticated user can't modify this album.
- `404` — No such album exists.

---

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