---
title: "Register media upload"
method: POST
path: "/media"
tags: ["media"]
---

# Register media upload

`POST /media`

Register your intent to upload media

The response includes all of the information needed to upload the media
to Pinterest.

To upload the media, make an HTTP POST request (using <tt>curl</tt>, for
example) to <tt>upload_url</tt> using the <tt>Content-Type</tt> header
value. Send the media file's contents as the request's <tt>file</tt>
parameter and also include all of the parameters from
<tt>upload_parameters</tt>.

<strong><a href='/docs/solutions/content-apps/#creatingvideopins'>Learn more</a></strong> about video Pin creation.

## Request body

- MediaUploadRequest — Media upload request
  - `media_type` 'video', required

## Response `201`

response

- MediaUpload — Media upload that has been registered but not uploaded/processed yet.
  - `media_id` string — Unique identifier for this media upload. Used to track status and for attaching during Pin creation.
  - `media_type` 'video'
  - `upload_url` string — The URL where you will POST your media file.
  - `upload_parameters` object — The list of parameter key/value pairs you will need to send with your POST request to upload your media file.
    - `x-amz-date` string
    - `x-amz-signature` string
    - `x-amz-security-token` string
    - `x-amz-algorithm` string
    - `key` string
    - `policy` string
    - `x-amz-credential` string
    - `Content-Type` string

## Other responses

- `default` — Unexpected error

## Changes

- **2022-01-07** (v5) `59a2e4171755` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/media/post.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/0d5998752011/schema)