create_launch
Destructive
create a new launch for publishing to social platforms
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": {
"title": "<title>"
},
"name": "create_launch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | wait for publishing to complete and return post URLs inline (returns 200). requires publish: true | |
| media | No | inline media (URL or base64, 1-10 items, mutually exclusive with media_assets) | |
| title | Yes | launch title | |
| publish | No | immediately publish after creation (returns 202). mutually exclusive with scheduled_date | |
| platforms | No | target platforms - required unless dropspace_platforms or user_platform_accounts is provided (inferred from their union) | |
| media_mode | No | media mode for the launch | |
| persona_id | No | persona ID for tone/style | |
| product_url | No | product URL — scraped to generate content; can substitute for product_description | |
| track_links | No | swap product_url in post copy for tracked redirects (twitter, linkedin, facebook, reddit, youtube); clicks show as metrics.tracked_clicks in analytics | |
| media_assets | No | pre-uploaded media asset references (mutually exclusive with media) | |
| custom_content | No | single content string for all platforms, or array of tweet strings for twitter thread mode (each ≤280 chars or ≤25,000 for X Premium, mutually exclusive with platform_contents) | |
| scheduled_date | No | ISO 8601 datetime to schedule (must be at least 15 minutes in the future) | |
| save_to_library | No | add the launch's uploaded media to the user's media library so autopilot can post it | |
| attribution_mode | No | how official-account posts credit the author: "handle" (default) signs with the connected @handle on that platform when one exists, "anonymous" always uses the plain "posted from dropspace user" note | |
| platform_contents | No | per-platform content — each value needs "content" (string). Instagram takes "instagram_settings": { "post_type": "feed" (default) | "carousel" | "story" | "trial_reel", "graduation_strategy"?: "MANUAL" (default) | "SS_PERFORMANCE" } and Facebook takes "facebook_settings": { "post_type": "feed" | "story" } - "carousel" (Instagram only) posts every attached image and the launch video as ONE carousel in media order, 2 to 10 items, where "feed" would post the video as a reel and leave the images out; "story" posts each image as a 24-hour story frame with no caption; "trial_reel" (Instagram only) posts the video as a reel shown to non-followers first, off the profile until it graduates - "MANUAL" when the creator shares it in the Instagram app, "SS_PERFORMANCE" when Instagram sees it performing well; Instagram allows trial reels from professional accounts with 200 or more followers, so a connected account below that bar is refused with the reason; a trial reel needs a video and leaves photos out. Reddit also requires "title" (max 300) and supports "metadata": { "subreddits": string[] (max 10, names without the r/ prefix — posts the launch once per subreddit, each tracked and retryable on its own; omit to post to the default community), "first_comment": string (max 1500 — posted as a comment under each reddit post once it goes live) }. for multi-account reddit, each connected account can target its own subreddits via "reddit:<account_id>" content keys (falls back to the base "reddit" block); a subreddit is posted by at most one of your accounts per launch (first wins, others skipped as SUBREDDIT_ALREADY_TARGETED). each subreddit has its own rules: many restrict or ban promotional posts and posting where the account has no history gets filtered, so target a few genuinely relevant subreddits rather than blasting. Twitter supports "thread" (string[], max 6, each ≤280 or ≤25,000 for X Premium) instead of "content". TikTok supports "tiktok_settings": { "publish_mode"?: "direct"|"draft" (default "direct"; "draft" uploads to the TikTok inbox to finish and publish in-app), "privacy_level": "PUBLIC_TO_EVERYONE"|"FOLLOWER_OF_CREATOR"|"MUTUAL_FOLLOW_FRIENDS"|"SELF_ONLY" (required before publish in direct mode; not required for draft), "allow_comments"?, "allow_duet"?, "allow_stitch"?, "is_commercial"?, "is_your_brand"?, "is_branded_content"?, "auto_add_music"? (booleans, direct mode), "cover_timestamp_ms"? (integer 0-600000 — which frame TikTok uses as the cover, in ms from the start; VIDEO posts only, photo posts take their cover by index; omit for the first frame) }. YouTube requires video and supports "title" (max 100 chars). character limits: Twitter 280/tweet (25,000 for X Premium), LinkedIn 3000, Instagram 2200, Reddit 3000, Facebook 3000, TikTok 4000, YouTube 5000 (description). X Premium status is auto-detected from the connected account. mutually exclusive with custom_content | |
| dropspace_platforms | No | platforms to post via official dropspace accounts | |
| product_description | No | product description — required unless product_url, custom_content, or platform_contents is provided | |
| media_attach_platforms | No | platforms to attach media to | |
| user_platform_accounts | No | map of platform key to token_id (UUID). a simple key targets your primary/only account: "twitter", "reddit", "instagram", "tiktok", "youtube". to target a SPECIFIC account when you have more than one on the same platform, use a composite key: Instagram/TikTok/YouTube/Twitter/Reddit use "instagram:<account_id>" / "tiktok:<account_id>" / "youtube:<account_id>" / "twitter:<account_id>" / "reddit:<account_id>" where <account_id> is the account entity_id from list_connections; LinkedIn uses "linkedin:personal" or "linkedin:organization:<org_id>"; Facebook posts go to a Page: a bare "facebook" key works when you have exactly one Page, using any connection id from list_connections as the value (the Page row id or the person row id) so dropspace resolves the Page; to target a specific Page among several, use a composite key, "facebook:page:<page_id>" or "facebook:<page_id>", where <page_id> is that Page row entity_id from list_connections; with several Pages and no page_id the API returns a 400 listing them. multiple keys allowed (e.g. post to two Instagram accounts at once). for Reddit, each targeted account runs its own subreddit fan-out | |
| custom_content_reddit_title | No | reddit title (required when custom_content is used with reddit platform) |