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

# Create Social Connection

> Create a social account linking URL.

Creates a new social connection setup flow and returns it as `connect_url`.

After the user completes the setup flow, call `GET /social/connections` to find the new `social_connection_id`.

Each setup flow creates one connected account slot. To connect another account on the same platform, create another social connection. If the organization cannot create another connection, the request returns an error and no setup URL is created.

## Request

```bash theme={null}
curl -X POST "https://api.mosaic.so/social/connections" \
  -H "Authorization: Bearer mk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "linkedin",
    "connection_name": "Mosaic LinkedIn"
  }'
```

## Body Parameters

| Field             | Type         | Required | Description                                                            |
| ----------------- | ------------ | -------- | ---------------------------------------------------------------------- |
| `platform`        | string       | Yes      | One of: `x`, `linkedin`, `instagram`, `facebook`, `tiktok`, `youtube`. |
| `connection_name` | string       | No       | Friendly label for the connection during setup.                        |
| `redirect_url`    | string (url) | No       | Override the post-connect redirect URL.                                |

## Response

```json theme={null}
{
  "platform": "linkedin",
  "connect_url": "https://api.mosaic.so/social/connect/v1.x6WRGq...c2fJ3A"
}
```