Media and assets

Social Media API for Multiple Images and Carousels

Attach multiple hosted image URLs to a social media post request for supported multi-image and carousel workflows.

Hosted mediaImagesCMS

How this API workflow works

Useful when your CMS, DAM, or media library already hosts the images and you want to send them directly by URL.

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 multiple images",
  "workspace": "WORKSPACE_ID",
  "media": [
    {
      "url": "https://example.com/image-1.jpg",
      "type": "image"
    },
    {
      "url": "https://example.com/image-2.jpg",
      "type": "image"
    },
    {
      "url": "https://example.com/image-3.jpg",
      "type": "image"
    }
  ],
  "target_platforms": [
    {
      "identifier": "instagram",
      "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 scheduler MCP AI agents