Upload Image or Video
Upload an image or small video file to include in your post
This endpoint allows you to upload a file or an image or small video to include in your post. Returned will be the URL to the image that can be used in the /post endpoint.
You can pass the file either as a multipart form data as a form parameter or a Base64 encoded file as a body parameter.
Important notes about media uploads:
-
For best performance, we recommend
- Hosting media files on your own server (e.g. AWS S3).
- Passing the media URL directly in the
mediaUrlsparameter of the /post endpoint. - This approach is faster than uploading files through this endpoint.
-
Media file retention
- Uploaded files are stored for 90 days.
- After 90 days:
- Published posts on social networks are unaffected.
- Scheduled posts will fail to publish if they reference expired media.
-
File size limits
- Maximum file size: 30 MB.
- For larger files, see our guide on handling large media uploads.
Header Parameters
Use multipart/form-data if sending a multipart form data - see below. Otherwise, send the standard application/json.
Body Parameters
Max 30 MB file size.
We recommend sending as a multipart form-data object instead of Base64 encoding.
The name of the file to be uploaded.
A description of the file.
Send as Multipart Form-Data
Send the media file as a multipart form-data object. Please be sure to specify the Content-Type as mentioned above.
Send as Base64
Send the media file as a Base64 encoded string as a Data URI string. The string should begin with data:content/type;base64
Example encoding with Output Format Data URI:
Note: The /post endpoint accepts larger files via an external URL with the mediaUrls parameter.