Create draft post
create_draft_postCreate a DRAFT post on a Flomixy Instagram, Threads, Facebook, LinkedIn, TikTok, Pinterest, YouTube, Bluesky, or Google Business Profile account. For YOUTUBE (a video; optional yt* options such as ytTitle, ytMadeForKids, ytPrivacyStatus): a draft may omit ytTitle/ytMadeForKids, but both are required before it can be scheduled. Address the target with channel + accountId (or the legacy instagramAccountId for Instagram only). The post is always subject to approval before it can be scheduled or published — it never goes live directly, no matter what this tool is called with. If the user wants a post with an image/video but gave no URL or media id, ask first which they prefer: (a) a public link, (a2) a file the AI itself produced: upload_media with contentBase64 (one file per call, up to 10 MB, no manual step), (b) upload via a Flomixy upload link (create_upload_link; with shell access curl the returned uploadEndpoint, no base64), (c) pick from the media library (list_media), (d) a stock photo (search_stock_photos, images only), (e) generate with AI: generate_image (images only, monthly quota), (f) no media, only if the network allows it (see get_channel_capabilities). If media is already provided, do not ask.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_draft_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ytTags | No | YOUTUBE only: tags, 500 characters in total (maxYtTagsChars; commas count, a tag with a space costs 2 more). | |
| caption | No | Post caption. The limit depends on the channel (e.g. Instagram 2200, Threads 500, LinkedIn 3000 UTF-8 bytes; see get_channel_capabilities maxCaptionBytes). | |
| channel | No | Publishing channel, canonically UPPERCASE (e.g. INSTAGRAM); lowercase is accepted too. Use with accountId instead of instagramAccountId. | |
| pinLink | No | PINTEREST only: destination link of the pin (http/https). The pin description has no clickable link, put the URL here. | |
| ytTitle | No | YOUTUBE only: video title, max 100 characters (maxYtTitleChars), no < or >. REQUIRED for a YOUTUBE target. | |
| pinTitle | No | PINTEREST only: pin title, max 100 characters (maxPinTitleChars). | |
| postType | No | Post format, canonically lowercase (image, carousel, reel, story); uppercase is accepted too. Defaults to image. | |
| accountId | No | The Flomixy account id for `channel`. Required for every channel except THREADS. | |
| gbpCtaUrl | No | GBP only: destination of the call-to-action button (http/https). | |
| mediaUrls | No | Media URLs for the post (http/https only). | |
| gbpCtaType | No | GBP only: call-to-action button. Every type except CALL needs gbpCtaUrl; CALL must not carry a URL. Ignored on OFFER. | |
| mediaTypes | No | Media types, e.g. ["image"] or ["video"]. | |
| pinAltText | No | PINTEREST only: image alt text, max 500 characters (maxPinAltTextChars). | |
| gbpEventEnd | No | GBP only: event/offer end, ISO 8601 WITH time zone; not before gbpEventStart. | |
| gbpOfferUrl | No | GBP only, OFFER: link to redeem the offer. | |
| gbpPostKind | No | GBP only: UPDATE (default), EVENT or OFFER. EVENT and OFFER REQUIRE gbpEventTitle, gbpEventStart and gbpEventEnd. | |
| bskyAltTexts | No | BLUESKY only: alt text per image, in the order of the images (max 2000 characters each, maxBskyAltTextChars). | |
| ytCategoryId | No | YOUTUBE only: video category id, e.g. "22" (People & Blogs). | |
| bskyReplyGate | No | BLUESKY only: who may reply (threadgate), everyone when omitted. | |
| gbpEventStart | No | GBP only: event/offer start, ISO 8601 WITH time zone. Interpreted in the location's own time zone by Flomixy. | |
| gbpEventTitle | No | GBP only: event/offer title (EVENT and OFFER). | |
| gbpOfferTerms | No | GBP only, OFFER: terms and conditions. | |
| ytMadeForKids | No | YOUTUBE only: "made for kids" declaration (COPPA). REQUIRED for a YOUTUBE target and has no default: ask the user, never guess. | |
| gbpOfferCoupon | No | GBP only, OFFER: coupon code. | |
| ytThumbnailUrl | No | YOUTUBE only: custom thumbnail URL (JPEG/PNG, max 2 MB). | |
| bskyLinkPreview | No | BLUESKY only: attach a link preview card for the first URL in the text (default true). | |
| ytPrivacyStatus | No | YOUTUBE only: visibility, public when omitted. | |
| ytSyntheticMedia | No | YOUTUBE only: the video contains altered or synthetic (AI-generated) realistic media. | |
| bskyContentLabels | No | BLUESKY only: self-applied content labels. | |
| bskyDisableQuotes | No | BLUESKY only: forbid quote posts (postgate). | |
| instagramAccountId | No | Legacy Instagram-only addressing. Prefer channel + accountId for any channel, including Instagram. | |
| ytNotifySubscribers | No | YOUTUBE only: notify subscribers about the upload (default true). |