Skip to main content

Integrations

Discover connected accounts, settings schemas, and dynamic tools

Listing Integrations​

List all connected social media accounts to get their IDs:

sipstory integrations:list

This returns a JSON array of integrations. Use jq to extract specific fields:

# Get just the IDs and platform names
sipstory integrations:list | jq '.[] | {id, identifier}'
# Find a specific platform
sipstory integrations:list | jq '.[] | select(.identifier=="reddit")'

Getting Settings​

Each platform has its own settings schema with character limits, required fields, and available options. Retrieve it with:

sipstory integrations:settings <integration-id>

The response tells you:

  • What fields are available (title, privacy level, subreddit, etc.)
  • Which fields are required
  • Character limits and validation rules
  • Available dynamic tools you can trigger
tip

Always check integrations:settings before posting to a new platform to understand what settings are available.

Triggering Tools​

Some platforms expose dynamic tools — for example, fetching Reddit flairs, YouTube playlists, or LinkedIn company pages. These return data you need when constructing platform-specific settings.

sipstory integrations:trigger <integration-id> <method-name>

Pass additional data with -d:

sipstory integrations:trigger <integration-id> <method-name> -d '{"key":"value"}'

Examples​

Get Reddit flairs for a subreddit:

sipstory integrations:trigger reddit-id getFlairs -d '{"subreddit":"programming"}'

Get YouTube playlists:

sipstory integrations:trigger youtube-id getPlaylists

Get LinkedIn company pages:

sipstory integrations:trigger linkedin-id getCompanies

Get Pinterest boards:

sipstory integrations:trigger pinterest-id getBoards

Discovery Workflow​

When working with a new platform, follow this workflow:

# 1. Find the integration ID
INTEGRATION_ID=$(sipstory integrations:list | jq -r '.[] | select(.identifier=="reddit") | .id')

# 2. Check what settings and tools are available
sipstory integrations:settings "$INTEGRATION_ID"

# 3. Use tools to fetch dynamic data (e.g., flairs)
sipstory integrations:trigger "$INTEGRATION_ID" getFlairs -d '{"subreddit":"programming"}'

# 4. Create a post with the discovered settings
sipstory posts:create \
  -c "My post" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"Post Title","type":"text"}}]}' \
  -i "$INTEGRATION_ID"