Docs

Connect your platforms

Instagram, TikTok, YouTube, Facebook, LinkedIn, Threads, Pinterest, X — the OAuth flows and the gotchas.

Every platform connection is handled from Workspace settings → Connections. Each one is a standard OAuth flow — you click Connect, approve BFM on the platform's consent screen, and the token lands in your workspace. We refresh tokens automatically; you only come back here if something was revoked.

Instagram (Business or Creator)

Instagram is the one that unlocks the most of the product: publishing, Reels, comment triggers, and insights all run on this connection.

  1. Make sure the account is Business or Creator. Personal accounts can't publish via the API.
  2. Click Connect Instagram on the Connections page.
  3. Pick the Instagram account you want to attach.
  4. Confirm the permissions — publishing, insights, and comment management are all required for the full feature set.
Gotcha
If you don't see your Instagram account on the consent screen, it's almost always because the Facebook user you're logged in as isn't an admin of the Facebook Page the Instagram account is linked to. Fix at facebook.com/business → Business Settings → People.

TikTok

TikTok uses the Content Posting API. Click Connect TikTok, approve, done. Comment triggers aren't available on TikTok yet — the platform doesn't deliver comment webhooks to third- party apps.

YouTube

Google OAuth, scope-limited to Shorts upload and video insights. You sign in with the Google account that owns the channel; multi-channel accounts prompt for which to attach.

Facebook

Facebook posting is a side-effect of the Instagram-business connection — the Facebook Page tied to that Instagram account can cross-post automatically. Pure Facebook-only workspaces aren't supported today.

Reconnecting

Tokens occasionally expire — a user revokes BFM from their platform settings, Meta re-prompts for consent after a policy change, etc. When that happens, the Connection row shows Needs reconnect and publishes to that platform pause. Click Reconnect, run through the flow again, and the queue picks up automatically.

Which permissions matter
For Instagram: instagram_content_publish, instagram_manage_comments, instagram_manage_messages, and instagram_business_manage_insights. If any are unchecked at consent time, the corresponding feature will fail silently with a "permission not granted" log line.