Create Social Connection
curl --request POST \
--url https://api.example.com/social/connectionsimport requests
url = "https://api.example.com/social/connections"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.example.com/social/connections', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/social/connections",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/social/connections"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/social/connections")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/social/connections")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodySocial
Create Social Connection
Create a social account linking URL.
POST
/
social
/
connections
Create Social Connection
curl --request POST \
--url https://api.example.com/social/connectionsimport requests
url = "https://api.example.com/social/connections"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.example.com/social/connections', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/social/connections",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/social/connections"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/social/connections")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/social/connections")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyCreates 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
| 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
{
"platform": "linkedin",
"connect_url": "https://api.mosaic.so/social/connect/v1.x6WRGq...c2fJ3A"
}
Was this page helpful?
⌘I