Skip to main content
This tool is part of the Content Tools category.

​
Parameters

NameTypeRequiredDescription
user_account_idstringYes*The ID of the user account to publish content from
platform_account_idstringYes*The platform account ID (alternative to user_account_id)
media_urlstringYesURL of the media file (image, video, etc.) to be published
formatstringYesFormat of the content (VIDEO, IMAGE, TEXT, AUDIO, OTHER)
typestringYesType of the content (see supported content types below)
titlestringNoTitle for the content
descriptionstringNoDescription or caption for the content
visibilitystringNoVisibility setting (PUBLIC, PRIVATE, UNLISTED, etc.)
tagsarray of stringsNoTags/hashtags to associate with the content
thumbnail_urlstringNoURL for the thumbnail image (for video content)
scheduled_forstring (ISO date)NoDate and time to schedule the content for future posting
*Either user_account_id or platform_account_id must be provided.

​
Supported Content Types

The following values are accepted for the type parameter:
  • FACEBOOK_POST - Facebook text/image/video post
  • INSTAGRAM_POST - Instagram image/video post
  • X_POST - X (Twitter) text/image/video post
  • FACEBOOK_STORY - Facebook story
  • INSTAGRAM_STORY - Instagram story
  • FACEBOOK_REEL - Facebook reel
  • INSTAGRAM_REEL - Instagram reel
  • LINKEDIN_POST - LinkedIn post
  • TIKTOK_VIDEO - TikTok video
  • YOUTUBE_VIDEO - YouTube video
  • YOUTUBE_SHORT - YouTube short
  • OTHER - Other content types

​
Example Request

{
  "user_account_id": "ua_12345678",
  "media_url": "https://example.com/media/video123.mp4",
  "format": "VIDEO",
  "type": "YOUTUBE_VIDEO",
  "title": "How to Use MCP for Content Management",
  "description": "In this video, we explain how to efficiently manage your content across multiple platforms using the Multi-Channel Platform (MCP).",
  "visibility": "PUBLIC",
  "tags": ["tutorial", "content management", "social media"],
  "thumbnail_url": "https://example.com/thumbnails/thumb123.jpg"
}

​
Example Response

{
  "job_id": "job_abc123def456",
  "status": "Here is your job id, you can use it to check the status of your job"
}

​
Usage Notes

  • The publishing process is asynchronous - you’ll receive a job ID to check the status of the publish operation.
  • Media files must be accessible via the provided URLs (public or pre-signed URLs).
  • If scheduled_for is provided, the content will be published at the specified time (must be in the future).
  • Different platforms support different media types and formats - verify compatibility before publishing.
  • For multi-media content collections (like carousels or albums), use Publish Content Group instead.
  • Media URLs should be publicly accessible or have appropriate permissions for the MCP service to access them.
  • The platform may perform additional validation before publishing, potentially resulting in a failed publication if requirements aren’t met.

​
Error Handling

Common errors include:
  • Invalid media URLs or inaccessible media files
  • Unsupported media formats for the specified platform
  • Authentication or permission issues
  • Rate limiting by the platform
  • Content policy violations