Skip to content

Media and assets

Social Media Media Upload API for Images and Videos

Upload images and videos, receive a Postly-hosted URL, and attach media to scheduled or published social posts.

UploadsImagesVideos

How this API workflow works

Use the file endpoint when your app has a local image or video file. After upload, use the returned URL in the media array.

  1. Create or copy a Postly API key.
  2. Resolve the organization, workspace, and connected target accounts.
  3. Build the request using the pattern below and destination-specific values.
  4. Create the post, then inspect its scheduled or publishing status.

Example request

// Step 1: use the "Upload a file" guide in docs.postly.ai

// Step 2: create the post
{
  "text": "Post with uploaded media",
  "workspace": "WORKSPACE_ID",
  "media": [
    {
      "url": "UPLOADED_FILE_URL",
      "type": "image"
    }
  ],
  "target_platforms": [
    {
      "identifier": "facebook",
      "id": "SOCIAL_ID"
    }
  ]
}

Build the complete workflow

Pair the REST API with Postly MCP agents, AI-assisted content creation, approvals, and the canonical social media scheduler.

Social media schedulerMCPAI agents