Hosted Flow

The hosted flow is the easiest way to connect accounts. You create a portal link, send the user there, and bundle.social handles the connect UI, provider OAuth, account picker, channel picker, language, and return flow. Endpoint: POST /api/v1/social-account/create-portal-link Test it in Swagger or the API Reference Client.

{
  "teamId": "team_123",
  "redirectUrl": "https://app.example.com/settings/social-accounts",
  "socialAccountTypes": ["FACEBOOK", "INSTAGRAM"],
  "instagramConnectionMethod": "FACEBOOK",
  "disableAutoLogin": true,
  "withBusinessScope": true,
  "expiresIn": 60,
  "language": "en"
}

Response:

{
  "url": "https://bundle.social/connect?token=..."
}

Redirect the user to url.

Required Fields

Field	Required	Description
`teamId`	Yes	Team that should receive the connected social account.
`socialAccountTypes`	Yes	Platforms available in the hosted flow. Uses values like `FACEBOOK`, `INSTAGRAM`, `LINKEDIN`, `YOUTUBE`.

redirectUrl is optional in the API contract, but you should provide it for normal app flows. It is the URL users return to after they click the back button.

OAuth Behavior Fields

Field	Required	Description
`redirectUrl`	No	HTTP/HTTPS URL to return to after the hosted flow. Recommended for most integrations.
`serverUrl`	No	Mastodon or Bluesky server URL. Mastodon requires a server when it is offered in the portal.
`disableAutoLogin`	No	Facebook, Instagram via Facebook, Instagram direct OAuth, and TikTok paths use this to avoid silently reusing the last logged-in platform session where supported. Defaults to `false`.
`tiktokForceLogin`	No	Experimental TikTok-only option. Routes TikTok through logout to request a fresh login session. Defaults to `false`.
`forceBrowserOAuth`	No	Instagram direct OAuth only. On phones, tries browser OAuth instead of the Instagram app flow. Defaults to `false`.
`instagramConnectionMethod`	No	Instagram only. Use `FACEBOOK` or `INSTAGRAM` to preselect the hosted portal connection method.
`withBusinessScope`	No	Facebook and Instagram via Facebook only. When provided, the hosted page skips the business vs standard scope chooser and uses your value.
`expiresIn`	No	Link lifetime in minutes. Min `5`, max `2880` (48 hours). Defaults to `10`.

For Facebook and Instagram via Facebook, tell users to select all Pages and Instagram accounts they manage in Meta OAuth. Then select the one Page or Instagram account for this team inside bundle.social.

Hosted UI Fields

Field	Required	Description
`logoUrl`	No	HTTPS image URL shown on the hosted page.
`userLogoUrl`	No	HTTPS user logo or avatar shown on the hosted page.
`userName`	No	User name shown on the hosted page.
`goBackButtonText`	No	Text for the back button.
`language`	No	Page language. Defaults to `en`.
`hidePoweredBy`	No	Hide the “powered by” text.
`hideGoBackButton`	No	Hide the back button.
`hideUserLogo`	No	Hide the user logo.
`hideUserName`	No	Hide the user name.
`hideLanguageSwitcher`	No	Hide the language switcher.
`showModalOnConnectSuccess`	No	Ask the user what to do after a successful connection: go back to `redirectUrl` or close and connect more accounts.
`maxSocialAccountsConnected`	No	Maximum number of social accounts that can be connected in the hosted flow.

Supported Languages

Code	Language
`en`	English
`pl`	Polish
`fr`	French
`hi`	Hindi
`sv`	Swedish
`de`	German
`es`	Spanish
`it`	Italian
`nl`	Dutch
`pt`	Portuguese
`ru`	Russian
`tr`	Turkish
`zh`	Chinese

Hosted Flow Steps

Create a portal link with POST /api/v1/social-account/create-portal-link.
Redirect the user to the returned url.
The user connects one or more accounts.
If a platform needs a channel, the hosted UI handles the picker.
The user returns to your app through redirectUrl or the back button.

For return query parameters, see Callback Parameters. Snapchat uses the Public Profile returned during OAuth and does not show a separate channel picker.

API Documentation

Platforms

Guides

Endpoints

Required Fields

OAuth Behavior Fields

Hosted UI Fields

Supported Languages

Hosted Flow Steps

​Required Fields

​OAuth Behavior Fields

​Hosted UI Fields

​Supported Languages

​Hosted Flow Steps

Required Fields

OAuth Behavior Fields

Hosted UI Fields

Supported Languages

Hosted Flow Steps