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.
- Create or copy a Postly API key.
- Resolve the organization, workspace, and connected target accounts.
- Build the request using the pattern below and destination-specific values.
- 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.