Skip to content

Media and assets

Social Media Video Posting API

Create channel-safe social video publishing requests with one uploaded or hosted video per Postly API post.

VideoMedia payloadChannel-safe

How this API workflow works

Keep the request simple: one video item in the media array for each post request.

  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

{
  "text": "Post with one video",
  "workspace": "WORKSPACE_ID",
  "media": [
    {
      "url": "https://example.com/video.mp4",
      "type": "video"
    }
  ],
  "target_platforms": [
    {
      "identifier": "linkedin",
      "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.