---
title: "Connect a Social Account"
method: POST
path: "/social_accounts/connect"
tags: ["Social Accounts"]
---

# Connect a Social Account

`POST /social_accounts/connect`

Starts an OAuth connection flow and returns an authorize_url where the user can connect a social account.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `account_id` string — The Account (biz_ identifier) to connect the social account for. An account-scoped API key may omit this to default to its own account.
  - `platform` 'meta_business' | 'tiktok', required — The platform to connect the social account on. Use `meta_business` to connect Meta Business assets, which is how Facebook Pages and Instagram accounts are connected — there is no separate `instagram` value. Use `tiktok` for TikTok accounts.
  - `redirect_url` string, required — Where to send the user once they finish connecting their accounts. Any `http` or `https` URL. If the connection fails, the user is redirected with a `social_account_error` query param.
  - `scopes` string[] — Capabilities to grant for the connected social account. `advertise` is required for both `meta_business` and `tiktok` connections — it is not conditional on whether you intend to run ads, and omitting it fails the request.

## Response `200`

authorize url returned

- object
  - `authorize_url` string, required — The OAuth authorization URL to redirect the user to.

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `409` — Conflict

## Changes

> 47 revisions in range; 1 not diffed.

- **2026-08-31** `4ddae15b5de8` — 1 breaking
  - the request property `redirect_url` became required
- **2026-08-12** `ae20b30817de` — 1 info
  - added the non-success response with the status `409`
- **2026-08-07** `f1020c3ecda4` — 2 info
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/code` to the response with the `401` status
- **2026-07-26** `60bbb4a6ffbc` — 2 info
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new `tiktok` enum value to the request property `platform`

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/social_accounts/connect/post.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/8473fa1d1f47/schema)