---
title: "Upload or Import Media"
method: POST
path: "/"
tags: ["Upload or Import Media"]
---

# Upload or Import Media

`POST /`

## Request

- Base URL: `https://upload.wistia.com`
- URL: `https://upload.wistia.com/`
- Auth: HTTP bearer

Endpoint to upload media files from a local system or import from a web URL.

- Use `multipart/form-data` with a `file` parameter to upload from local system
- Use `application/x-www-form-urlencoded` with a `url` parameter to import from web URL

## Request body `application/x-www-form-urlencoded`

- object
  - `project_id` string: The hashed id of the project to upload media into.
  - `name` string: A display name to use for the media in Wistia.
  - `description` string: A description to use for the media in Wistia.
  - `contact_id` integer: A Wistia contact id.
  - `access_token` string: A 64 character hex string. This parameter can be found on your API access page OR can be the token you received from authenticating via Oauth2. Note this approach is legacy and discouraged. We recommend using Bearer Token authentication.
  - `url` string, uri, required: The publicly accessible web location of the media file to import.
  - `low_priority` boolean: Inform the encoding service that this upload can be considered lower priority than others. This is especially useful for platform customers doing bulk uploads or migrations. Setting this to "false" has no effect.

## Response `200`

Successfully uploaded or imported.

- object: Response after successfully uploading or importing media
  - `id` integer: A unique numeric identifier for the media within the system.
  - `name` string: The display name of the media.
  - `type` string: A string representing what type of media this is.
  - `created` string, date-time: The date when the media was originally uploaded.
  - `updated` string, date-time: The date when the media was last changed.
  - `duration` number: Specifies the length (in seconds) for audio and video files.
  - `hashed_id` string: A unique alphanumeric identifier for this media.
  - `progress` number: A floating point value between 0 and 1 that indicates the progress of the processing for this file.
  - `thumbnail` object
    - `url` string
    - `width` integer
    - `height` integer

## Other responses

- `400`: Error due to reaching the video limit of your account or other issues.
- `401`: Authorization error. Check your access_token.

---

[API](https://skmtc.dev/wistia/apis/upload-api.md) - [All operations](https://skmtc.dev/wistia/apis/upload-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wistia/apis/upload-api/revisions/705d04baaaf2?raw)