SFEED.DEV
Docs FAQ Privacy Terms

Posting

Basic post

sfeed post "Just shipped a new feature"

If you have one connected Page, sfeed posts to the platforms supported by that Page. If you have multiple connected Pages, add --page to choose one first.

Target specific platforms

sfeed post "Just shipped a new feature" --to facebook
sfeed post "Just shipped a new feature" --to instagram
sfeed post "Just shipped a new feature" --to facebook,instagram

Post from a specific page

sfeed post "Release note" --page "Acme Robotics"

If you have multiple connected Pages, use --page with a page name or page ID. sfeed does not keep a default posting Page anymore.

Attach media

sfeed post "New dashboard" --to facebook --media ./screenshot.jpg
sfeed post "New dashboard" --to instagram --media ./screenshot.jpg
sfeed post "Launch clip" --to facebook --media ./demo.mp4

--media accepts local files or public URLs. sfeed stages local files automatically when Instagram or hosted scheduling needs a public URL.

Supported post shapes are simple on purpose. Facebook supports text-only, single image, multi-image, and single video posts. Instagram supports single image, single video, and image-only carousels. Instagram does not support text-only posts.

Schedule a post

sfeed post "Monday motivation" --at "2026-04-01T09:00:00Z"
sfeed post "Tomorrow's clip" --to instagram --media ./clip.mp4 --at "2026-04-01T09:00:00Z"

Hosted scheduling checks for due posts every minute.

Hosted scheduling requires a subscription. If you schedule local media, sfeed hosts it temporarily for the scheduled job.

Scheduled posts that rely on local files must be within 90 days. Local staged files must be 100 MB or smaller.

Dry run

sfeed post "test" --dry-run

Shows what would be posted without actually posting.

Options

Back to Docs