---
title: "Create portal link"
method: POST
path: "/api/v1/social-account/create-portal-link"
tags: ["socialAccount"]
---

# Create portal link

`POST /api/v1/social-account/create-portal-link`

Simplify connect flow. Create a portal link which can be used to manage connected social accounts directly on bundle.social platform without implementing the logic on your side.

## Request body

- object
  - `teamId` string, required
  - `redirectUrl` string, uri
  - `socialAccountTypes` string[], required
  - `serverUrl` string, uri — Mastodon or Bluesky only
  - `disableAutoLogin` boolean — Optional. If true, portal will request provider-specific anti-auto-login behavior where supported.
  - `tiktokForceLogin` boolean — Optional and experimental. TikTok only. When true, portal routes TikTok authorization through logout to request a fresh login session.
  - `forceBrowserOAuth` boolean — 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
  - `withBusinessScope` boolean — Optional. Facebook and Instagram only - when provided, portal skips business scope selection modal for Facebook login paths.
  - `expiresIn` integer — Time in minutes, after which the link will expire. Minimum 5 minutes, maximum 48 hours.
  - `logoUrl` string, uri
  - `userLogoUrl` string, uri
  - `userName` string
  - `goBackButtonText` string
  - `hidePoweredBy` boolean
  - `hideGoBackButton` boolean
  - `hideUserLogo` boolean
  - `hideUserName` boolean
  - `hideLanguageSwitcher` boolean
  - `showModalOnConnectSuccess` boolean
  - `language` 'en' | 'pl' | 'fr' | 'hi' | 'sv' | 'de' | 'es' | 'it' | 'nl' | 'pt' | 'ru' | 'tr' | 'zh'
  - `maxSocialAccountsConnected` number

## Response `200`

200

- object
  - `url` string, required

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/bundle/apis/bundle-social-api.md) · [All operations](https://skmtc.net/bundle/apis/bundle-social-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bundle/bundle-social-api/versions/b773556c2f09/schema)