Authentication

Connect Facebook and Instagram

sfeed auth facebook

This opens your browser. You log in to Facebook, approve the permissions, and sfeed saves the connection it needs for posting and scheduling.

You do not create a separate sfeed account for this step. There is no email signup, Google login, or other social-provider login for sfeed. You only approve Meta so sfeed can post to the Facebook Pages and Instagram accounts you choose.

Instagram is connected automatically if your Facebook Page is linked to an Instagram Business or Creator account.

If you only want to post to Instagram, this is still the command to run. Meta exposes Instagram publishing through the linked Facebook Page connection.

What happens

1. sfeed opens your browser
2. You approve access in Facebook
3. sfeed finishes the connection and saves the auth state it needs

Check connection status

sfeed auth status

Shows which platforms are connected and which account they're linked to.

Disconnect

sfeed auth revoke facebook

Removes the saved Meta connection from sfeed on this machine. Instagram auth is tied to the same Facebook Page connection, so there is no separate revoke instagram command.

This does not remove the Meta-side app authorization. To reset Facebook's consent screen too, remove sfeed from Facebook Settings > Business Integrations.

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 -- for Instagram posting, your IG account must be a Business or Creator account linked to a Facebook Page. Convert in Instagram Settings > Account > Switch to Professional Account.

Meta setup help: professional accounts, connect Instagram and a Page, add or change the connected Page.

Permissions we request

When you connect, Facebook asks you to approve these permissions:

• pages_show_list -- list your Pages
• pages_manage_posts -- create and edit posts on your Page
• pages_read_engagement -- read engagement data (needed for Instagram)
• pages_read_user_content -- read content on your Page
• business_management -- access business assets
• instagram_basic -- basic Instagram account info
• instagram_content_publish -- publish to Instagram

We don't request email, messaging, ads, or analytics permissions.

Fully disconnect sfeed

To completely remove sfeed's access to your accounts:

1. Remove the saved connection in sfeed: sfeed auth revoke facebook
2. Revoke Facebook permissions: go to Facebook Settings > Business Integrations, find sfeed, and click Remove

After removing from Facebook, sfeed can no longer post to any of your accounts.

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 a professional account linked to the Facebook Page you connected. If needed, use Meta's help pages above, then run sfeed auth facebook again.
• "Invalid Scopes" -- this usually means a Facebook permission grant is stale or incomplete. Remove sfeed from Business Integrations, then run sfeed auth facebook again.
• Permissions not granted -- if you previously connected sfeed with fewer permissions, Facebook caches the old grant. Go to Business Integrations, remove sfeed, then run sfeed auth facebook again.

Back to Docs