Documentation

Platform apps

Use your own Meta and X developer app credentials for OAuth and API calls.

Why bring your own app?

unifeed can use platform app credentials you configure per unifeed user. This lets you control OAuth branding, app review scopes, and rate limits on your Meta/X apps.

Supported networks

GET /api/v1/platform-apps lists configured networks: facebook, instagram, x. LinkedIn is listed but not yet available.

Upsert credentials

PUT /api/v1/platform-apps/facebook

{
  "app_id": "YOUR_META_APP_ID",
  "app_secret": "YOUR_META_APP_SECRET",
  "graph_version": "v22.0"
}

Omit app_secret on update to keep the existing secret. First-time setup requires both app_id and app_secret.

Meta OAuth redirect URLs

Add these to your Meta app (Valid OAuth Redirect URIs):

https://your-unifeed-domain.com/oauth/callback/facebook
https://your-unifeed-domain.com/oauth/callback/instagram

Local dev typically uses a tunnel (e.g. loca.lt) for Meta HTTPS callbacks. See the dashboard OAuth panel for your current URLs.

Required Meta permissions

pages_show_list
pages_read_engagement
pages_manage_posts
pages_manage_engagement (comments)