Skip to main content
POST
/
social
/
connections
Create Social Connection
curl --request POST \
  --url https://api.example.com/social/connections
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

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

FieldTypeRequiredDescription
platformstringYesOne of: x, linkedin, instagram, facebook, tiktok, youtube.
connection_namestringNoFriendly label for the connection during setup.
redirect_urlstring (url)NoOverride the post-connect redirect URL.

​
Response

{
  "platform": "linkedin",
  "connect_url": "https://api.mosaic.so/social/connect/v1.x6WRGq...c2fJ3A"
}