Publish & Cross-Post Across 18 Social Networks
posts_publishPublish immediately (publish_now), schedule for a future ISO-8601 timestamp (schedule), enqueue into the profile slot queue (queue), or simultaneously cross-post (cross_post) content and media across 18+ social networks. Includes the built-in X Smart Link Optimizer (xLinkStrategy: 'first_reply'), which automatically strips external links from the main X post and publishes them in an immediate 1st reply—cutting X API link costs by 85% ($0.03 vs $0.20) while avoiding main-feed link reach penalties. Returns the persisted postId, per-platform delivery receipts (platformResults), total API cost (totalCostUsd), and exact dollar savings (totalSavedViaSmartLinkUsd).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>",
"platforms": "<platforms>"
},
"name": "posts_publish"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Optional tags or keywords for YouTube, TikTok, or CMS posts. | |
| title | No | Optional headline, YouTube/TikTok video title, LinkedIn PDF carousel title, or Reddit/Pinterest post title. | |
| action | Yes | Publishing mode: 'publish_now' dispatches immediately, 'cross_post' syndicates tailored variants across multiple networks at once, 'schedule' holds until `scheduledFor`, and 'queue' places the post in the next best engagement slot. | |
| format | No | Publication format. 'post' (default) is a regular feed post. 'story' publishes an Instagram Story: requires platforms=['instagram'], action='publish_now', exactly ONE media item (one entry in `mediaUrls` or `mediaAssetIds`; image .jpg/.png or video .mp4/.mov, ideally 9:16, video 3-60s) and NO caption (omit `content` or pass an empty string). Videos are processed by Instagram before going live. | post |
| content | No | Primary post body text, caption, or thread hook. May include hashtags, mentions, and URLs (external URLs on X are automatically handled according to `xLinkStrategy`). | |
| accountId | No | Optional connected account id (`acc_...`) to publish with. When set, that exact account (and its token) is used for its platform instead of auto-selecting one. | |
| mediaUrls | No | Optional direct URLs to images (.png, .jpg, .webp), videos (.mp4, .mov), or documents (.pdf, .pptx, .docx for LinkedIn Document Carousels). | |
| platforms | Yes | Non-empty array of destination social network slugs to publish or cross-post to (e.g. `['x', 'linkedin', 'bluesky', 'threads']`). | |
| profileId | No | Brand profile identifier (`prof_...`) whose connected social accounts will publish the post. | prof_allometrik |
| visibility | No | Optional visibility setting (e.g. 'public' or 'connections' on LinkedIn; 'public', 'unlisted', or 'private' on YouTube/TikTok). | |
| webhookUrl | No | Optional https URL that receives a JSON post.published / post.failed / post.partial event when an Instagram/Threads post that returned status 'processing' (media container still being processed by Meta) is finished by the background job. | |
| firstComment | No | Optional first comment or reply to publish immediately under the main post. | |
| scheduledFor | No | Optional ISO-8601 UTC or offset timestamp (e.g. '2026-10-27T08:30:00+01:00') specifying when a scheduled post should go live. | |
| thumbnailUrl | No | Optional public image URL for a YouTube custom thumbnail at publish time (prefer `thumbnailMediaAssetId`). Same `thumbnails.set` path as `thumbnailMediaAssetId`. | |
| mediaAssetIds | No | Optional list of Nuntior media asset IDs (`med_...`) from `media_pipeline` or `/v1/media/upload` to attach as images, PDF document carousels, or videos. | |
| xLinkStrategy | No | X (Twitter) link optimization mode: 'first_reply' moves any URL to an automated 1st reply to save $0.17/post (85% X API cost reduction) and maximize organic impressions; 'inline' leaves the URL in the main tweet; 'bio' replaces the URL with a bio pointer. | first_reply |
| autoAdjustMedia | No | When true, automatically selects the matching aspect-ratio variant (9:16 for Reels/TikTok/Shorts, 16:9 or 1:1 for X/LinkedIn) for each target platform. | |
| authModeOverride | No | Optional authentication override forcing delivery through 'managed' Nuntior OAuth credentials or 'byok' customer-supplied keys. | |
| thumbnailMediaAssetId | No | Optional Nuntior image media asset (`med_...`) used as the YouTube custom thumbnail at publish time via `POST /upload/youtube/v3/thumbnails/set`. Does not replace the video file. Thumbnail failures are returned in `thumbnailErrorDetail` and do not roll back a successful video upload. |