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

# Upload a video

`POST /me/videos`

Begin the video upload process. 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 parameters. * Error code 2204: The request contains invalid body parameters. * Error code 2230: The upload type is invalid. * Error code 3116: If a `type` payload parameter was supplied instead of `upload.approach`.
- `401` — Error code 8002: No user is associated with the authentication token.
- `403` — * Error code 4102: The user's allotted quota has been reached. * Error code 4101: The user's maximum disk space has been reached.
- `500` — Error code 4003: There is a problem initiating the upload.

## Changes

- **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`
- **2018-12-05** `26f856a94041` — 3 breaking, 2 warning, 6 info
  - removed the required property `metadata/connections/available_albums` from the response with the `201` status
  - removed the required property `metadata/connections/available_channels` from the response with the `201` status
  - removed the required property `type` from the response with the `201` status
  - removed the optional property `metadata/connections/versions/resource_key` from the response with the `201` status
  - …7 more

[Change 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.dev/vimeo/apis/vimeo-api/revisions/d7ed89f8d03e?raw)