Publish Content

Publishes new content to a social media or content platform. This tool allows you to create posts, videos, images, or other content types across various platforms through a unified API.

This tool is part of the Content Tools category.

Parameters

Name	Type	Required	Description
user_account_id	string	Yes*	The ID of the user account to publish content from
platform_account_id	string	Yes*	The platform account ID (alternative to user_account_id)
media_url	string	Yes	URL of the media file (image, video, etc.) to be published
format	string	Yes	Format of the content (VIDEO, IMAGE, TEXT, AUDIO, OTHER)
type	string	Yes	Type of the content (see supported content types below)
title	string	No	Title for the content
description	string	No	Description or caption for the content
visibility	string	No	Visibility setting (PUBLIC, PRIVATE, UNLISTED, etc.)
tags	array of strings	No	Tags/hashtags to associate with the content
thumbnail_url	string	No	URL for the thumbnail image (for video content)
scheduled_for	string (ISO date)	No	Date 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

Related Tools

• Get Content By ID - Retrieve published content by ID
• Refresh Contents - Refresh content data from platforms
• Publish Content Group - Publish multi-media content groups