Sign in

v1

latestOpenAPI 3.0.22026-07-261530825.5 KB
socialAccount

Connect social account for team

Generate OAuth URL for social account connection. Redirect user to this URL to connect social account.

post/api/v1/social-account/connect

Request body

type'TIKTOK' | 'YOUTUBE' | 'INSTAGRAM' | 'FACEBOOK' | 'TWITTER' | 'THREADS' | 'LINKEDIN' | 'PINTEREST' | 'REDDIT' | 'MASTODON' | 'DISCORD' | 'SLACK' | 'BLUESKY' | 'GOOGLE_BUSINESS' | 'SNAPCHAT' required
teamIdstring required
redirectUrlstring uri required

Client-provided return URL. After the OAuth flow completes (success or error), the user will be redirected here with success/error query params appended. Must be a well-formed http/https URL.

serverUrlstring uri

Mastodon or Bluesky only

disableAutoLoginboolean

Optional. When true, adds provider-specific flags to avoid automatic login/auto-approval where supported.

tiktokForceLoginboolean

Optional and experimental. TikTok only. When true, routes authorization through TikTok logout to request a fresh login session.

forceBrowserOAuthboolean

Optional. Instagram only. When true, direct Instagram connections on phones will try to force browser login to avoid the Instagram iOS app deep-link bug.

instagramConnectionMethod'FACEBOOK' | 'INSTAGRAM'

Instagram only - connection method

withBusinessScopeboolean

Facebook and Instagram only - include business_management, ads_management, ads_read scopes

Response

200

urlstring required

OAuth URL - Redirect user to this URL to connect social account