---
title: "Generate social connection URL"
method: POST
path: "/social-profiles/connection-url"
---

# Generate social connection URL

`POST /social-profiles/connection-url`

Returns a browser URL that starts connecting a social network to a workspace. Open the returned URL while signed in to Ocoya to approve OAuth and select profiles.

## Query parameters

- `workspaceId` string, required

## Request body

- object
  - `provider` 'facebook' | 'instagram' | 'x' | 'linkedin' | 'pinterest', required — Social network used for the connection flow.

## Response `200`

Success

- object
  - `url` string, required — Browser URL to open while signed in to Ocoya to start the connection flow.

## Other responses

- `400` — Unsupported provider
- `500` — Unknown error

---

[API](https://skmtc.net/ocoya/apis/ocoya-api.md) · [All operations](https://skmtc.net/ocoya/apis/ocoya-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ocoya/ocoya-api/versions/80ba891a0523/schema)