> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ocoya.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ocoya_get_social_connection_url

> Get a browser URL to connect a social network.

# `ocoya_get_social_connection_url`

Returns an Ocoya URL that starts connecting a social network to a workspace. The user opens the URL in a browser, approves the social network OAuth flow, then selects the profiles to connect.

Instagram Business uses Facebook authentication first, then returns to the Instagram profile selection step.

## Arguments

| Name          | Type   | Required | Description                                                                      |
| ------------- | ------ | -------- | -------------------------------------------------------------------------------- |
| `workspaceId` | string | Yes      | Workspace ID from `ocoya_list_workspaces`.                                       |
| `provider`    | string | Yes      | One of `facebook`, `instagram`, `twitter`, `linkedin`, `pinterest`, or `tiktok`. |

## Example

```json theme={null}
{
  "name": "ocoya_get_social_connection_url",
  "arguments": {
    "workspaceId": "cmayvq3hk00017apshay5qezu",
    "provider": "instagram"
  }
}
```

## Returns

Returns `authUrl`, `callbackUrl`, the requested `provider`, and the OAuth `authProvider` used to start the flow.

Open `authUrl` in a browser while signed in to Ocoya.