Skip to main content

Provider Integrations

Quick links: Frontend • Backend

Backend​

Providers implemented via Functions:

  • Facebook Pages: OAuth via FB Login, long‑lived user token; selects managed Page and posts to feed.
  • Instagram (Graph): OAuth via FB Login, IG Business Account mapping via Page; image container + publish.
  • Threads: OAuth via Meta; text posts.
  • X: OAuth 2.0 PKCE (plus OAuth1 for media); posts tweets.
  • TikTok: OAuth 2.0; access/refresh tokens; user profile fetch; direct publish for video/photo with status polling; token refresh endpoints and sweep; polling and organic repost support.
  • YouTube: OAuth 2.0; access/refresh tokens; publish; refresh sweep.
  • LinkedIn: OAuth 2.0; UGC posts.

Data locations:

  • users/{uid}/integrations/{provider} holds token details and provider‑specific extra metadata.
  • users/{uid}/organicPosts/* stores detected organic posts (e.g., TikTok) for repost flows.
  • Sweeps refresh tokens near expiry to ensure uninterrupted publishing.

Client flow:

  • UI triggers Functions *_start endpoint with Authorization: Bearer <idToken> and redirect=1.
  • After connecting, provider redirects to *_callback, which persists tokens and redirects back to return_to.

Related frontend: see Frontend

Frontend​

  • useConnectIntegration hook calls startAuth(platform, idToken, window.location.href, isLocal) and navigates to { authUrl }.
  • PlatformPicker renders connected provider profiles from users/{uid}/integrations/*.
  • usePublish* hooks call publish endpoints with request bodies documented per provider.

Related backend: see Backend