v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB

media

Register media upload

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

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

Learn more about video Pin creation.

post/media

Request body

media_type'video' required

Response

The request has succeeded.

media_idstring required

Unique identifier for this media upload. Used to track status and for attaching during Pin creation.

media_type'video' required

upload_urlstring

The URL where you will POST your media file.

Example response

{
  "media_id": "12345",
  "upload_parameters": {
    "Content-Type": "multipart/form-data",
    "key": "uploads/11/aa/22/3:video:203014033110991560:5212123920968240771",
    "policy": "eyJleHBpcmF0aW9uIjoiMj..==",
    "x-amz-algorithm": "AWS4-HMAC-SHA256",
    "x-amz-credential": "ASIA6QZJ64OPIKV7FRVX/20220127/us-east-1/s3/aws4_request",
    "x-amz-date": "20220127T185143Z",
    "x-amz-security-token": "IQoJb3JpZ2luX2VjEJr...==",
    "x-amz-signature": "fcd6309a6aaee213348666a72abed8b44552a43acb6b340e8e1b288d21a5fe92"
  },
  "upload_url": "https://pinterest-media-upload.s3-accelerate.amazonaws.com/"
}