Sign in
media

Register media upload

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/content/content-creation/#Creating%20video%20Pins'>Learn more</a></strong> about video Pin creation.

post/media

Request body

media_type'video' required

Example request

{
  "media_type": "video"
}

Response

response

media_idstring

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

media_type'video'
upload_urlstring

The URL where you will POST your media file.

Example response

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

Changes