Skip to main content
POST
Connect an External Account

Authorizations

Authorization
string
header
required

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Headers

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-11-04-1"

Body

application/json
platform
enum<string>
required

The platform to connect the external account on. Use tiktok to connect the authenticated user’s TikTok profile, linkedin for their LinkedIn profile, youtube for their YouTube channel, or x for their X profile. Use quickbooks to connect the account’s QuickBooks Online company: pass account_id, and the user picks the company in QuickBooks.

Available options:
tiktok,
linkedin,
youtube,
x,
quickbooks
Example:

"quickbooks"

redirect_url
string
required

Where to send the user once they finish connecting their accounts. Must be an https URL on whop.com; any other host is rejected. On success, the user is redirected with an external_account_connected query param naming the platform; if the connection fails, with an external_account_error query param instead. The same values also arrive as social_account_connected / social_account_error.

Example:

"https://whop.com/dashboard/biz_xxxxxxxxxxxxxx/settings"

account_id
string

The Account (biz_ identifier) to connect the external account for. An account-scoped API key may omit this to default to its own account. Omit for user profile connections.

Example:

"biz_xxxxxxxxxxxxxx"

Response

authorize url returned

authorize_url
string
required

The OAuth authorization URL to redirect the user to.

Example:

"https://appcenter.intuit.com/connect/oauth2"