SSocial

Setup

Get the stack running, register each platform's OAuth app, then connect the accounts you publish from.

API checking…http://localhost:3001

1. Install and run

  1. 1

    Configure the environment

    Copy the example file and generate the 32-byte keys used for token encryption and API auth.

    cp .env.example .env
    openssl rand -hex 32 # ENCRYPTION_KEY
    openssl rand -hex 32 # ADMIN_TOKEN
  2. 2

    Start Postgres and apply migrations

    The database stores accounts, encrypted OAuth tokens, and the scheduler queue.

    docker compose up -d postgres
    corepack pnpm install
    corepack pnpm db:migrate
  3. 3

    Run the dashboard and API

    With MOCK_MODE=true everything works end to end without any platform credentials.

    corepack pnpm dev

2. Register OAuth apps

Each platform needs its own developer app. Register this callback URL, then put the client id and secret in .env.

http://localhost:3001/api/oauth/<platform>/callback

The redirect is signed with an HMAC state valid for ten minutes, and tokens are stored AES-256-GCM encrypted.

3. Connect accounts

Connect each platform you want to publish to. In mock mode publishing works without connecting anything.

  • Instagram

    Not connected

    Publishes a media container to a Business/Creator account. Media is required.

    • META_CLIENT_ID
    • META_CLIENT_SECRET
    • INSTAGRAM_PAGE_ID
  • Facebook

    Not connected

    Posts to a Page feed, attaching a single image or video link.

    • META_CLIENT_ID
    • META_CLIENT_SECRET
    • FACEBOOK_PAGE_ID
  • WhatsApp

    Not connected

    Sends the text to opted-in recipients through the Cloud API — there is no broadcast post.

    • META_CLIENT_ID
    • META_CLIENT_SECRET
    • WHATSAPP_PHONE_NUMBER_ID
    • WHATSAPP_RECIPIENTS
  • LinkedIn

    Not connected

    Shares a member ugcPost. Member tokens are refreshed automatically.

    • LINKEDIN_CLIENT_ID
    • LINKEDIN_CLIENT_SECRET
  • Substack

    Publishing unsupported

    Substack exposes no public API for publishing, so this platform is read-only here.

    No publishing API Developer docs
  • YouTube

    Not connected

    Resumable videos.insert upload. Requires exactly one video URL.

    • YOUTUBE_CLIENT_ID
    • YOUTUBE_CLIENT_SECRET
    • YOUTUBE_PRIVACY_STATUS
  • Snapchat

    Publishing unsupported

    Snapchat has no public API for publishing organic content, so publishing is unsupported.

    No publishing API Developer docs
  • TikTok

    Not connected

    Pulls one video from a verified domain. Unaudited apps may only post privately.

    • TIKTOK_CLIENT_KEY
    • TIKTOK_CLIENT_SECRET
    • TIKTOK_PRIVACY_LEVEL
  • Strava

    Not connected

    Strava has no feed post, so a published draft becomes an activity.

    • STRAVA_CLIENT_ID
    • STRAVA_CLIENT_SECRET
    • STRAVA_SPORT_TYPE