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

  1. sfeed opens your browser
  2. You approve access in Facebook or Instagram
  3. sfeed stores the provider credential encrypted on its hosted control plane
  4. 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

Meta setup help: professional Instagram accounts.

Fully remove sfeed access

To completely remove sfeed's access to your accounts:

  1. Run sfeed auth facebook revoke --all --yes and sfeed auth instagram revoke
  2. Revoke Facebook permissions: go to Facebook Settings > Business Integrations, find sfeed, and click Remove
  3. 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

Back to Docs