---
title: "Connect social account for team"
method: POST
path: "/api/v1/social-account/connect"
tags: ["socialAccount"]
---

# Connect social account for team

`POST /api/v1/social-account/connect`

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

## Request body

- object
  - `type` 'TIKTOK' | 'YOUTUBE' | 'INSTAGRAM' | 'FACEBOOK' | 'TWITTER' | 'THREADS' | 'LINKEDIN' | 'PINTEREST' | 'REDDIT' | 'MASTODON' | 'DISCORD' | 'SLACK' | 'BLUESKY' | 'GOOGLE_BUSINESS' | 'SNAPCHAT', required
  - `teamId` string, required
  - `redirectUrl` string, 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.
  - `serverUrl` string, uri — Mastodon or Bluesky only
  - `disableAutoLogin` boolean — Optional. When true, adds provider-specific flags to avoid automatic login/auto-approval where supported.
  - `tiktokForceLogin` boolean — Optional and experimental. TikTok only. When true, routes authorization through TikTok 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 — Facebook and Instagram only - include business_management, ads_management, ads_read scopes

## Response `200`

200

- object
  - `url` string, required — OAuth URL - Redirect user to this URL to connect social account

## 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)