POST media/upload

Upload media (images) to Twitter, to use in a Tweet or Twitter-hosted Card.

Be sure your POST is a multipart/form-data request. You may either upload the raw binary of the file or it’s base64-encoded contents. The resulting media_id or media_id_string will be used to pass to the POST statuses/update or card-related API endpoints. See our uploading media guide for more on using this endpoint.

Uploaded media files will be available for attachment for 60 minutes before they are flushed from the servers (if not attached to a Tweet or card). Note that you need to call the upload endpoint once per media file you want to upload (so to upload three media files, call the upload endpoint three times, storing the media_ids ready to be attached to your POST statuses/update).

If you would like to allow additional users to use your media until its expiration time (60 minutes), pass the X-Additional-Owners header with the user’s numeric user id, otherwise access will be limited only to the user who uploaded the media.

The media and media_data parameters are mutually exclusive.

Note: The domain for this endpoint is upload.twitter.com

Resource URL

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

https://upload.twitter.com/1.1/media/upload.json

Example Result

{
  "media_id": 553639437322563584,
  "media_id_string": "553639437322563584",
  "size": 998865,
  "image": {
    "w": 2234,
    "h": 1873,
    "image_type": "image/jpeg"
  }
}