---
title: "Generate OAuth URL"
method: POST
path: "/social-accounts/authorization-url"
tags: ["Social Accounts"]
---

# Generate OAuth URL

`POST /social-accounts/authorization-url`

## Request

- Base URL: `https://api.woopsocial.com/v1`
- URL: `https://api.woopsocial.com/v1/social-accounts/authorization-url`
- Auth: HTTP bearer

Generates a browser authorization URL for connecting a new social account to a project.

This endpoint is useful for multi-user integrations where your application lets
your own users, clients, or brands connect their social accounts to WoopSocial
without giving them access to your WoopSocial account.

A common flow is:
1. Create or select a WoopSocial project for your user, client, or brand.
2. Call this endpoint from your backend with that `projectId`, the target `platform`,
   and a `redirectUrl` in your application.
3. Open the returned `url` in your user's browser.
4. After OAuth completes, WoopSocial redirects the browser back to `redirectUrl`
   with result query parameters.
5. Use `projectId` and `socialAccountIds` from the redirect, or call
   `GET /social-accounts?projectId=...`, to store or confirm the connected account
   in your application.

When `redirectUrl` is provided, the browser is redirected back to that URL after
the OAuth callback is handled.

For Facebook, WoopSocial shows a page-selection screen after authorization
because Facebook may return more pages than the user appeared to select in
the Facebook dialog in cases where the user has authorized with WoopSocial previously. The selected pages are connected to the single
`projectId` from this request, then WoopSocial redirects back to
`redirectUrl` when one was provided.

When `redirectUrl` is provided, WoopSocial appends these query parameters on success:
- `status=success`
- `projectId`: the project identifier from the request
- `platform`: the connected social platform
- `socialAccountIds`: comma-separated connected social account identifiers. This may contain one or more IDs depending on the platform OAuth flow.

When `redirectUrl` is provided, WoopSocial appends these query parameters on failure:
- `status=error`
- `projectId`: the project identifier from the request
- `platform`: the requested social platform
- `error`: an OAuth callback error code

If the OAuth callback state is missing or expired, WoopSocial cannot safely
determine the original `redirectUrl`, so the callback returns an HTTP error
instead of redirecting.

The redirect never includes OAuth tokens or credentials.

## Request body

- CreateOAuthAuthorizationRequest
  - `platform` 'PINTEREST' | 'LINKEDIN' | 'LINKEDIN_PAGES' | 'INSTAGRAM' | 'FACEBOOK' | 'THREADS' | 'TIKTOK' | 'X' | 'YOUTUBE' | 'WOOPTEST', required: Identifies which social media platform this data structure targets.
  - `projectId` string, required: Project identifier.
  - `redirectUrl` string, uri: Optional URL in your application to return the browser to after OAuth completes. Use this for multi-user integrations where your users connect their own social accounts through your app. WoopSocial appends OAuth result query parameters to this URL so your app can finish the connection flow. The redirect does not include tokens or credentials.

## Response `200`

OAuth authorization URL created.

- CreateOAuthAuthorizationResponse
  - `url` string, uri, required: Browser URL that starts the OAuth authorization flow.

## Other responses

- `429`: Too many requests are already in progress for this API key.

---

[API](https://skmtc.dev/woopsocial/apis/woopsocial-api.md) · [All operations](https://skmtc.dev/woopsocial/apis/woopsocial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/woopsocial/apis/woopsocial-api/revisions/578a984c20d9?raw)