Connect a social account
Initiates account connection. For OAuth2 platforms returns an auth_url to redirect the user to. For apikey/credentials platforms stores the credentials immediately and returns account_id.
Authorizations
Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...
Body
Platform and metadata
BrandID optionally specifies which brand to attach the account to. If omitted, a new brand is auto-created.
"b_01HZ9X3Q4R5M6N7P8V2K0W1J"
Metadata contains platform-specific connection data
Platform identifies the social platform to connect (e.g. instagram, facebook, google, threads, tiktok, linkedin).
"instagram"
RedirectURI is the customer's URL to redirect the user to after OAuth completes. If you have registered redirect URIs in the dashboard, the value must match one of them. If you have none registered, any valid https URI is accepted. If omitted, the default HTML success page is shown.
"https://app.acme.com/oauth/done"
CustomerState is an opaque value echoed back to the customer's redirect URI. Max 512 chars.
"session_abc123"