Skip to main content

Platform Examples

Ready-to-use examples for posting to specific platforms

X (Twitter)​

Simple Post​

sipstory posts:create \
  -c "Hello Twitter!" \
  -s "2025-01-15T10:00:00Z" \
  -i "twitter-id"

Thread​

sipstory posts:create \
  -c "Thread 1/3: Introduction" \
  -c "Thread 2/3: Main point" \
  -c "Thread 3/3: Conclusion" \
  -s "2025-01-15T10:00:00Z" \
  -d 2000 \
  -i "twitter-id"

With Reply Controls​

sipstory posts:create \
  -c "Only followers can reply to this" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"who_can_reply_post":"followers"}' \
  -i "twitter-id"

Reddit​

Post with Flair​

# 1. Get available flairs
sipstory integrations:trigger reddit-id getFlairs -d '{"subreddit":"programming"}'

# 2. Post with a flair
sipstory posts:create \
  -c "My post content" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"Post Title","type":"text","flair":{"id":"flair-id","name":"Discussion"}}}]}' \
  -i "reddit-id"

Scripted Workflow​

#!/bin/bash
REDDIT_ID=$(sipstory integrations:list | jq -r '.[] | select(.identifier=="reddit") | .id')
FLAIRS=$(sipstory integrations:trigger "$REDDIT_ID" getFlairs -d '{"subreddit":"programming"}')
FLAIR_ID=$(echo "$FLAIRS" | jq -r '.output[0].id')

sipstory posts:create \
  -c "Automated Reddit post" \
  -s "2025-01-15T10:00:00Z" \
  --settings "{\"subreddit\":[{\"value\":{\"subreddit\":\"programming\",\"title\":\"Post Title\",\"type\":\"text\",\"flair\":{\"id\":\"$FLAIR_ID\"}}}]}" \
  -i "$REDDIT_ID"

YouTube​

# Upload video first
VIDEO=$(sipstory upload video.mp4)
VIDEO_URL=$(echo "$VIDEO" | jq -r '.path')

sipstory posts:create \
  -c "Video description here" \
  -m "$VIDEO_URL" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"title":"My Video Title","type":"public","tags":[{"value":"tech","label":"Tech"}]}' \
  -i "youtube-id"

TikTok​

# Upload video first
VIDEO=$(sipstory upload video.mp4)
VIDEO_URL=$(echo "$VIDEO" | jq -r '.path')

sipstory posts:create \
  -c "Check this out! #fyp" \
  -m "$VIDEO_URL" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"privacy_level":"PUBLIC_TO_EVERYONE","duet":true,"stitch":true}' \
  -i "tiktok-id"

Instagram​

# Upload image first
IMAGE=$(sipstory upload photo.jpg)
IMAGE_URL=$(echo "$IMAGE" | jq -r '.path')

# Regular post
sipstory posts:create \
  -c "Beautiful day! #photography" \
  -m "$IMAGE_URL" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"post_type":"post"}' \
  -i "instagram-id"

Story​

sipstory posts:create \
  -c "Story content" \
  -m "$IMAGE_URL" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"post_type":"story"}' \
  -i "instagram-id"

Reel​

sipstory posts:create \
  -c "Reel caption" \
  -m "$VIDEO_URL" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"post_type":"reel"}' \
  -i "instagram-id"

LinkedIn​

sipstory posts:create \
  -c "Professional update on LinkedIn" \
  -s "2025-01-15T10:00:00Z" \
  -i "linkedin-id"
sipstory posts:create \
  -c "Check out these slides!" \
  -m "image1.jpg,image2.jpg,image3.jpg" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"post_as_images_carousel":true}' \
  -i "linkedin-id"

Pinterest​

sipstory posts:create \
  -c "Pin description" \
  -m "$IMAGE_URL" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"board":"board-id","title":"Pin Title","link":"https://example.com"}' \
  -i "pinterest-id"

Discord​

sipstory posts:create \
  -c "Message to Discord" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"channel":"channel-id"}' \
  -i "discord-id"

Batch Scheduling​

Schedule multiple posts across different dates:

#!/bin/bash
DATES=("2025-01-14T09:00:00Z" "2025-01-15T09:00:00Z" "2025-01-16T09:00:00Z")
CONTENT=("Monday motivation" "Tuesday tips" "Wednesday wisdom")

for i in "${!DATES[@]}"; do
  sipstory posts:create \
    -c "${CONTENT[$i]}" \
    -s "${DATES[$i]}" \
    -i "twitter-id"
done

Multi-Platform Campaign​

Post different content per platform in one command using a JSON file:

sipstory posts:create --json campaign.json

Example campaign.json:

{
  "integrations": ["twitter-123", "linkedin-456", "reddit-789"],
  "posts": [
    {
      "provider": "twitter",
      "post": [{ "content": "Short tweet version", "image": [] }]
    },
    {
      "provider": "linkedin",
      "post": [{ "content": "More detailed LinkedIn post with professional tone", "image": [] }]
    },
    {
      "provider": "reddit",
      "post": [{ "content": "Reddit post body", "image": [] }],
      "settings": {
        "__type": "reddit",
        "subreddit": [{ "value": { "subreddit": "programming", "title": "Post Title", "type": "text" } }]
      }
    }
  ]
}