CLI Commands Reference | SocialRails Documentation

Full command reference for the SocialRails CLI. All commands output JSON to stdout.

posts:create

Schedule or draft a new post.

# Schedule a post
socialrails posts:create -c "Check out our new feature!" -p twitter -s "2026-03-15T14:30:00Z"
 
# Create a draft (omit -s)
socialrails posts:create -c "Draft post for review" -p linkedin

Thread support (Twitter/Threads)

socialrails posts:create --thread \
  -c "1/ Here's why we built SocialRails" \
  -c "2/ Managing 9 platforms is chaos" \
  -c "3/ One API to schedule everywhere" \
  -c "4/ Try it free at socialrails.com" \
  -p twitter -s "2026-03-15T14:30:00Z"

posts:batch

Post to multiple platforms at once.

socialrails posts:batch -c "Big announcement!" --platforms twitter,linkedin,facebook -s "2026-03-15T14:30:00Z"

posts:list

List posts with optional filters.

socialrails posts:list --status scheduled --platform twitter --limit 10

posts:delete

Delete a draft or scheduled post.

socialrails posts:delete <post-id>

analytics

View posting analytics.

socialrails analytics --period 30d --platform twitter

accounts

List connected social media accounts.

socialrails accounts

accounts:settings

Get account settings and capabilities.

socialrails accounts:settings <account-id>

ai:generate

Generate AI-powered social media content.

socialrails ai:generate --prompt "Write a tweet about our product launch" --platform twitter --tone excited

upload

Upload media for use in posts.

# From a local file
socialrails upload ./image.jpg --type image
 
# From a URL
socialrails upload --url "https://example.com/photo.jpg" --type image

workspace

Get workspace info including plan limits and usage.

socialrails workspace

Supported Platforms

Twitter/X, LinkedIn, Facebook, Instagram, TikTok, Bluesky, Pinterest, Threads, YouTube.