Generate OAuth URL

curl --request POST \
  --url https://api.woopsocial.com/v1/social-accounts/authorization-url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "<string>",
  "platform": "PINTEREST",
  "redirectUrl": "https://app.example.com/oauth/complete"
}
'

{
  "url": "<string>"
}

Social Accounts

Generate OAuth URL

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:

Create or select a WoopSocial project for your user, client, or brand.
Call this endpoint from your backend with that projectId, the target platform, and a redirectUrl in your application.
Open the returned url in your user’s browser.
After OAuth completes, WoopSocial redirects the browser back to redirectUrl with result query parameters.
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.

On success, WoopSocial appends these query parameters to redirectUrl:

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.

On failure, WoopSocial appends these query parameters to redirectUrl:

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.

POST

/

social-accounts

/

authorization-url

Generate OAuth URL

curl --request POST \
  --url https://api.woopsocial.com/v1/social-accounts/authorization-url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "<string>",
  "platform": "PINTEREST",
  "redirectUrl": "https://app.example.com/oauth/complete"
}
'

{
  "url": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

projectId

string

required

Project identifier.

platform

enum<string>

required

Identifies which social media platform this data structure targets.

Available options:

PINTEREST,

LINKEDIN,

LINKEDIN_PAGES,

INSTAGRAM,

FACEBOOK,

TIKTOK,

X,

YOUTUBE,

WOOPTEST

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.

Example:

"https://app.example.com/oauth/complete"

Response

200 - application/json

OAuth authorization URL created.

url

string<uri>

required

Browser URL that starts the OAuth authorization flow.

Delete project List social accounts