create_post
Schedule or immediately publish one social media post. DESTRUCTIVE WRITE that creates content on the user's connected social account. An immediate post (no scheduled_at, or a time within a minute) comes back with status publishing. A future time comes back as scheduled. If it is saved but cannot be queued, the call errors and says whether it will still be sent when it is due. Always confirm caption + scheduled_at + account_id/workspace with the user before calling. For Instagram, distinguish caption @mentions from native instagram_settings.user_tags and co-author instagram_settings.collaborators; call list_platforms with view=schema and account_id before either native feature. Native media tags work with eligible direct or Meta-linked accounts; collaborators require an eligible Meta-linked account. Instagram caption add-ons (caption_addon poll or comment prompt) need a Facebook Login account, a caption, and a feed photo, Reel, or carousel. Stories are rejected, and a poll cannot be combined with a comment prompt. Third-party media URLs are copied into posterly storage before the post is saved; short-lived signed URLs must still be live when this tool runs. For multiple posts, prefer create_posts_batch after confirming every item. On an error or lost reply, retry with the same idempotency_key; a repeat within 10 minutes returns the original post (deduplicated: true). TikTok: with no privacy_level it posts directly using the saved default or public (tiktok_audience_defaulted); post_mode inbox sends it to the app.
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": {
"confirm": "<confirm>"
},
"name": "create_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| caption | No | Post caption/text. On Instagram, @username is a caption mention, not a native tag or collaborator invite. Optional on Instagram Stories (first slide only in a series). Ignored when thread_posts is provided. | |
| confirm | Yes | Must be true after the user explicitly confirms the post/account/workspace/schedule. | |
| metadata | No | ||
| platform | No | Platform name when using username. Supported: instagram, facebook, tiktok, twitter, linkedin, youtube, pinterest, threads, google_business, telegram, bluesky, discord, slack, mastodon, devto, hashnode, wordpress, lemmy. Aliases x, gmb, and instagram-standalone are also accepted by the API. | |
| settings | No | Deprecated alias of platform_settings (or instagram_settings for Instagram). Prefer those instead. | |
| username | No | Account username; requires platform. | |
| media_url | No | Media URL. Posterly storage URLs are used as-is; third-party URLs are copied into posterly storage first. Short-lived signed URLs must still be live when this tool runs. | |
| post_type | No | Optional post type. Omit for auto-detection from media. Supported semantic values include text, image, video, carousel, reel, story, story_series, document, x_thread, threads_thread, photo, and cover_photo. | |
| account_id | No | Social account ID from list_accounts. | |
| media_urls | No | Media URLs, handled like media_url. | |
| scheduled_at | No | ISO 8601 UTC datetime. Omit to publish immediately. | |
| thread_posts | No | For X or Threads: 2+ entries, one per post in the reply chain. | |
| workspace_id | No | Workspace ID from whoami. | |
| idempotency_key | No | Optional retry key. Reuse the same value if this create errors or the response is lost. | |
| platform_settings | No | Platform-specific composer controls, flattened across platforms (unrelated fields ignored). Required: YouTube title; Pinterest board_id (cover_image_url also required for video Pins); Lemmy community. Accepted via passthrough but not listed below: Lemmy community/title, Dev.to canonical_url, Hashnode publication_id, Telegram parse_mode/disable_web_page_preview, Google Business post_type (STANDARD/EVENT/OFFER, alias topic_type), TikTok auto_add_music/photo_cover_index/media_type, Facebook post_type (incl. cover_photo), Mastodon language. Call list_platforms with view=schema and account_id for fields and examples. | |
| instagram_settings | No | Instagram-specific settings: native media tags (user_tags) and co-author invitations (collaborators). Call list_platforms with view=schema and account_id first. |