Authentication
Connect accounts
sfeed auth facebook connect
sfeed auth instagram connect Run the command for each platform you want. Facebook can connect multiple business portfolios to the same sfeed identity. Connecting a different business adds a connection; reconnecting the same business refreshes its access. Other business connections remain available.
You do not create a separate sfeed product account for this step. You only approve Meta so sfeed can post to the Facebook Pages and Instagram accounts you choose.
Facebook connects Pages only. Instagram connects one professional Business or Creator account directly and does not require a Facebook Page or business portfolio.
What happens
- sfeed opens your browser
- You approve access in Facebook or Instagram
- sfeed stores the provider credential encrypted on its hosted control plane
- The CLI stores only your sfeed identity and safe destination metadata
Check connection status
sfeed auth status Shows which platforms are connected and which account they're linked to.
Multiple Facebook connections
sfeed auth facebook connect
sfeed auth facebook connections
sfeed auth facebook connections --json
sfeed destinations Use the Facebook profile with access to the business you want to connect. The browser controls the Facebook identity; sfeed does not store Facebook passwords or switch browser profiles. Different profiles authorizing the same business refresh the same connection.
Each Page appears once in destinations, even if multiple connections can access it. Use a Page ID when names are duplicated. Scheduled jobs stay attached to their destination and use an available credential at execution time.
When reconnecting a business, include every Page you still want that connection to access. Omitted Pages lose that connection's access. sfeed warns when a Page loses its last active credential and reports how many pending jobs need attention. Reconnecting does not bypass Meta's portfolio ownership or Page-access requirements.
Revoke access
sfeed auth facebook revoke --connection CONNECTION_ID
sfeed auth facebook revoke --connection CONNECTION_ID --yes
sfeed auth instagram revoke Copy the connection ID from sfeed auth facebook connections. Without --yes, Facebook revocation previews affected Pages and pending jobs without changing access. With multiple connections, choose one explicitly. To remove all Facebook connections, use sfeed auth facebook revoke --all to preview, then add --yes to confirm.
Revoking a connection removes its stored credential, not its Pages or scheduled jobs. A Page remains usable when another active connection provides access. Pending jobs without access may fail unless you reconnect or cancel them. Direct Instagram access is unchanged.
This does not remove Meta-side app authorization. Removing sfeed in Facebook Business Integrations can affect other connections, so do not use it to disconnect just one Page or business in sfeed.
Requirements
- Facebook Page -- the API posts to Pages, not personal profiles. If you don't have a Page, create one at facebook.com/pages/create.
- Instagram Business/Creator account -- direct Instagram posting requires a professional Business or Creator account. Convert in Instagram Settings > Account > Switch to Professional Account.
Meta setup help: professional Instagram accounts.
Fully remove sfeed access
To completely remove sfeed's access to your accounts:
- Run
sfeed auth facebook revoke --all --yesandsfeed auth instagram revoke - Revoke Facebook permissions: go to Facebook Settings > Business Integrations, find sfeed, and click Remove
- Remove sfeed from Instagram's connected-app settings if you also used direct Instagram auth
Removing only the Facebook integration does not revoke a separate direct Instagram connection.
Troubleshooting
- "No Facebook Pages found" -- make sure you have at least one Facebook Page. Create one at facebook.com/pages/create.
- "Instagram not connected" -- make sure the Instagram account is professional, then run
sfeed auth instagram connect. - Missing permissions -- check
sfeed auth facebook connectionsand reconnect the affected business, selecting the Pages you need. Check your Page access in Meta before considering a broader authorization reset.