Upload Media

Upload an image or video file to your SchedPilot media library. The returned media_id can then be passed to the Create Post endpoint via the image_ids or video_ids arrays.

Endpoint​

POST https://api.schedpilot.com/developers/v1/media/upload

Authentication​

Include either your API key or OAuth token on every request.

Request​

Send the file as multipart/form-data. The form field name must be file.

File size limit​

5 GB maximum per file.

Supported file types​

Example Request​

curl -X POST "https://api.schedpilot.com/developers/v1/media/upload" \
  -H "X-API-KEY: smm_your_key_here" \
  -F "file=@photo.jpg"

Uploading a video:

curl -X POST "https://api.schedpilot.com/developers/v1/media/upload" \
  -H "X-API-KEY: smm_your_key_here" \
  -F "file=@promo.mp4"

Response​

HTTP 201 Created

{
  "media_id": "image-42",
  "type": "image",
  "mime_type": "image/jpeg"
}

For a video upload:

{
  "media_id": "video-7",
  "type": "video",
  "mime_type": "video/mp4"
}

Response fields​

Using the media_id in a Post​

Pass the returned media_id to the Create Post endpoint:

• For images: include the value in the image_ids array.
• For videos: include the value in the video_ids array.

Error Responses​