create_post_draft
Hold a post as a pending draft WITHOUT sending it. Nothing reaches any platform until you show the user the exact post, they say yes in chat, and you call approve_draft(draftId); a draft nobody approves expires after 24 hours and the post never goes out. Never tell the user to open the Socialync app to approve it: the whole flow stays in this chat. When the user has already confirmed the post, call publish_now instead (one step). Returns a draft_id, expiry, and dailyDraftsRemaining. Supports up to 10 images total via imageUrls (public https URLs) and/or base64Images (image bytes). Cannot attach video. Cannot draft to TikTok or YouTube (use schedule_post_draft for those). Instagram requires at least one image. Hard cap: 10 drafts per UTC day per profile -- platform-security mechanism to keep the user's accounts under Meta/X/LinkedIn spam-detection thresholds, not a Socialync restriction. ALWAYS run validate_post with these same arguments FIRST and resolve every error it reports before calling this.
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": {
"caption": "<caption>"
},
"name": "create_post_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| caption | Yes | Post caption/text. Will be shown to the user in the approval modal exactly as written. | |
| imageUrls | No | Up to 10 publicly fetchable image URLs (https). Socialync copies them into its own storage when you call this tool, so the links only have to work right now (an expiring export link is fine). Per-platform image caps: X 4, Bluesky 4, LinkedIn 9, IG/FB/Threads 10. Combined with base64Images cannot exceed 10 total. | |
| platforms | No | Platforms to draft for. One or more of: facebook, instagram, linkedin, twitter, threads, bluesky. TikTok/YouTube are not allowed here (use schedule_post_draft). Pass platforms OR audienceId, not both. | |
| profileId | No | The Socialync profile to post from. Call list_profiles to see the profiles you can post to. Required only when this connection is authorized for more than one profile; if exactly one is authorized it is used automatically. | |
| audienceId | No | A saved audience id from list_audiences. Expands to the platforms that audience reaches on the target profile; any member it cannot reach (other brand, needs reconnect, secondary account without its primary) is reported back in skippedMembers instead of failing the call. Use INSTEAD of platforms, never together. | |
| base64Images | No | Up to 10 images encoded as base64 strings (data URIs like "data:image/png;base64,..." also accepted). Use this when the user uploaded image(s) to you directly. Socialync hosts them so the URLs are guaranteed reachable at publish time. Per-image cap: 8MB. Supported: jpeg, png, webp, gif. Combined with imageUrls cannot exceed 10 total. | |
| firstComment | No | Optional "first comment": text Socialync posts as a comment under the post right after it publishes -- the classic home for hashtags and links, keeps the caption clean. One string for all platforms. Supported: instagram, threads, twitter, youtube, linkedin, bluesky. Facebook and TikTok do not support it (they record it as skipped; the post itself is unaffected). Per-platform comment length limits are enforced at draft time: instagram 2200, threads 500, twitter 280, youtube 10000, linkedin 1250, bluesky 300. A failed comment never fails the post. | |
| exceptPlatforms | No | Only valid together with audienceId: platforms to leave out of the expanded audience for this one post (e.g. exclude tiktok when the post has no video). | |
| platformSpecificSettings | No | Per-platform caption overrides if you want different wording for different platforms (e.g. shorter for Bluesky/Threads). |