Media Requirements

Postifys media requirements for Facebook, Instagram, YouTube, Pinterest, LinkedIn, and TikTok, including proxyDownload, Drive/Dropbox, and media queue APIs.

Last updated: 2026-07-24 · Technical source: live Postifys API behavior and API reference

General rules

• Use completed files - not still-encoding local exports.
• Prefer direct CDN/S3 HTTPS URLs when the platform can fetch them.
• Each network enforces its own size, duration, aspect ratio, and codec rules.
• If a URL is not publicly fetchable, publish attempts fail with media fetch errors.

proxyDownload and Drive/Dropbox

On Facebook, Instagram, and Pinterest publish calls, proxyDownload tells Postifys to download the media to temporary storage first.

• Images may be re-served through a short-lived Postifys URL for the platform to fetch.
• Videos/Reels use the platform upload/resumable flows after Postifys downloads the file.
• Google Drive and Dropbox links automatically enable proxy mode.
• Drive files must be shared as Anyone with the link.
• Temp files are deleted after publish.

curl -X POST https://postifys.com/api/instagram/post \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "REEL",
    "mediaUrls": ["https://drive.google.com/uc?export=download&id=FILE_ID"],
    "text": "New Reel from Google Drive",
    "instagramAccountId": "INSTAGRAM_ACCOUNT_ID",
    "proxyDownload": true
  }'

By platform

Facebook

• Feed text/link, native images, and Reels.
• Pass mediaUrls for images/Reels; use type IMAGE, REEL, or FEED.

Instagram

• Professional accounts only.
• mediaUrls required. Types: IMAGE, VIDEO, REEL.
• Reels/videos often use Meta resumable upload after download.

YouTube

• videoUrl required and must be downloadable.
• Optional thumbnailUrl, privacyStatus (private default), tags, category.

Pinterest

• Image URL required for image Pins (imageUrl or first mediaUrls item).
• Write access depends on Pinterest application approval.

LinkedIn

• Member profiles: text, image (imageUrl), video (videoUrl), or link posts.
• Company Pages are not currently offered.

TikTok

• Public MP4 URL recommended via videoUrl.
• Upload goes to the creator inbox; creator completes publishing in TikTok.
• Direct Post is not claimed unless separately approved.

Optional media queue APIs

You can prepare remote media asynchronously before publishing:

• POST /api/media/queue - queue a download (returns 202)
• GET /api/media/status?mediaJobId=... - check job state
• GET /api/media/queue - list jobs (browser session)

Prepared files may be served from signed temporary URLs under /media/tmp/:token/:filename. Tokens expire and are not a public media CDN.