Post Social / Docs / API and CLI reference

Command line

For terminals, scripts and agents without MCP. JSON in, JSON out; add --pretty to read it yourself.

npx postsocial login                     # sign in through your browser
npx postsocial list-social-accounts --pretty
npx postsocial upload --file ./launch.mp4   # prints the media id when it's ready
npx postsocial create-post --caption "We're live!" \
  --media-ids <media id> \
  --destinations '[{"account_id":"<id>","options":{"media_type":"reel"}}]' \
  --scheduled-at 2026-10-06T15:00:00Z
npx postsocial create-post --help           # every option for a command

On a server or in CI, use --key ps_live_... or set POSTSOCIAL_API_KEY. Test keys (ps_test_...) can do everything except publish.