posts:create

Create, schedule, queue, or draft a social media post across one or more platforms simultaneously.

Usage

Bash

simplified posts:create [options]

Options

Flag	Short	Type	Required	Description
--content	-c	string	✅*	Post text/caption
--accounts	-a	string	✅*	Comma-separated account IDs
--action		string	✅	add_to_queue · schedule · draft
--date		string		Schedule date YYYY-MM-DD HH:MM (UTC, required for schedule)
--timezone		string		Timezone override (default: UTC)
--media		string		Comma-separated media URLs
--additional		JSON string		Platform-specific settings (see below)
--json		path	✅*	Path to JSON file with full post definition

*Either --content + --accounts or --json is required.

Actions

Action	Description
add_to_queue	Add to posting queue
schedule	Schedule for specific date/time (requires --date)
draft	Save as draft

Examples

Bash

# Queue a post
simplified posts:create -c "Hello world!" -a "ACCOUNT_ID" --action add_to_queue

# Post to multiple platforms simultaneously
simplified posts:create \
  -c "Launch day!" \
  -a "INSTAGRAM_ID,LINKEDIN_ID,BLUESKY_ID" \
  --action add_to_queue

# Schedule a post
simplified posts:create \
  -c "Launching soon!" \
  -a "ACCOUNT_ID" \
  --action schedule \
  --date "2026-04-01 09:00"

# Save as draft
simplified posts:create -c "Work in progress" -a "ACCOUNT_ID" --action draft

# Post with media
simplified posts:create \
  -c "Check this out" \
  -a "ACCOUNT_ID" \
  --action add_to_queue \
  --media "https://example.com/image.jpg"

# Complex post from JSON file
simplified posts:create --json post.json

# Instagram Reel
simplified posts:create \
  -c "New reel!" \
  -a "ACCOUNT_ID" \
  --action add_to_queue \
  --media "https://example.com/video.mp4" \
  --additional '{"instagram":{"postType":{"value":"reel"},"channel":{"value":"direct"}}}'

Platform-Specific Settings (--additional)

Pass a JSON string to --additional for platform-specific options:

Platform	Key settings
Instagram	postType (post/reel/story), channel (direct/reminder)
TikTok	postType, channel, privacyStatus
YouTube	postType, post.title (required)
LinkedIn	audience (PUBLIC/CONNECTIONS/LOGGED_IN)
Facebook	postType (post/reel/story)

Platform Character Limits

Platform	Limit
Bluesky	300
Threads	500
Pinterest	500
Google Business	1500
LinkedIn	3000
Instagram / Facebook / TikTok / YouTube	2200