---
title: "Upload a video"
method: POST
path: "/me/videos"
tags: ["Videos\\Uploads"]
---

# Upload a video

`POST /me/videos`

This method begins the video upload process for the authenticated user. For more information, see our
[upload documentation](https://developer.vimeo.com/api/upload/videos).

## Response `201`

The upload procedure has begun.

## Other responses

- `400` — * Error code 2205: The body of the request isn't formatted properly. * Error code 2204: The request contains invalid body parameters. * Error code 2230: The upload type is invalid. * Error code 3116: The **type** payload parameter was supplied instead of **upload.approach**. Use **upload.approach** starting from API version 3.4.
- `401` — Error code 8002: No user is associated with the access token.
- `403` — * Error code 4102: The authenticated user's allotted quota has been reached. * Error code 4101: The authenticated user's maximum disk space has been reached.
- `500` — Error code 4003: There is a problem initiating the upload.

## Changes

- **2026-07-13** `ea882e0224a4` — 4 info
  - the endpoint scheme security `oauth2` was added to the API
  - added the optional property `metadata/connections/versions/resource_key` to the response with the `201` status
  - added the required property `metadata/connections/available_albums` to the response with the `201` status
  - added the required property `metadata/connections/available_channels` to the response with the `201` status
- **2019-04-12** `80428f626f3e` — 1 warning, 2 info
  - removed the request property `ratings`
  - api tag `Videos\Uploads` added
  - api tag `Videos\Upload` removed
- **2019-03-29** `d66f7a79837f` — 1 info
  - added the required property `type` to the response with the `201` status
- **2019-02-22** `0aaf609c3dbf` — 1 info
  - added the optional property `password` to the response with the `201` status
- **2019-01-11** `89b756668a1e` — 2 info
  - added `#/components/schemas/project` to the `parent_folder` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/folder` from the `parent_folder` response property `allOf` list for the response status `201`

[Full history](https://skmtc.dev/vimeo/apis/vimeo-api/changes/me/videos/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)