Add connector(s) to the team
curl --request POST \
--url https://bee.theswarm.com/team/add-connector \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"linkedin_usernames": [
"<string>"
]
}
'import requests
url = "https://bee.theswarm.com/team/add-connector"
payload = { "linkedin_usernames": ["<string>"] }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({linkedin_usernames: ['<string>']})
};
fetch('https://bee.theswarm.com/team/add-connector', 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://bee.theswarm.com/team/add-connector",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'linkedin_usernames' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://bee.theswarm.com/team/add-connector"
payload := strings.NewReader("{\n \"linkedin_usernames\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://bee.theswarm.com/team/add-connector")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"linkedin_usernames\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://bee.theswarm.com/team/add-connector")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"linkedin_usernames\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"usernames_not_found": [
"<string>"
],
"users_added": [
"<string>"
],
"users_exist": [
"<string>"
]
}{
"usernames_not_found": [
"<string>"
],
"users_added": [
"<string>"
],
"users_exist": [
"<string>"
]
}{
"code": 123,
"errors": [
"<string>"
]
}Team Management
Add Connector
Add one or more LinkedIn profiles as connectors to your team.
POST
/
team
/
add-connector
Add connector(s) to the team
curl --request POST \
--url https://bee.theswarm.com/team/add-connector \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"linkedin_usernames": [
"<string>"
]
}
'import requests
url = "https://bee.theswarm.com/team/add-connector"
payload = { "linkedin_usernames": ["<string>"] }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({linkedin_usernames: ['<string>']})
};
fetch('https://bee.theswarm.com/team/add-connector', 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://bee.theswarm.com/team/add-connector",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'linkedin_usernames' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://bee.theswarm.com/team/add-connector"
payload := strings.NewReader("{\n \"linkedin_usernames\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://bee.theswarm.com/team/add-connector")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"linkedin_usernames\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://bee.theswarm.com/team/add-connector")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"linkedin_usernames\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"usernames_not_found": [
"<string>"
],
"users_added": [
"<string>"
],
"users_exist": [
"<string>"
]
}{
"usernames_not_found": [
"<string>"
],
"users_added": [
"<string>"
],
"users_exist": [
"<string>"
]
}{
"code": 123,
"errors": [
"<string>"
]
}Adds LinkedIn profiles as connectors to your team. A single request can include multiple usernames, making it efficient to onboard connectors in bulk.
Connectors are the team members whose LinkedIn connections form your searchable network. The more connectors you have, the broader your network coverage.
For a conceptual overview, see Team Management — Add Connector.
Omit the parameter to add connectors without a group assignment.
Omitting the header adds connectors to the team associated with your API key. The
Processing
Connector mapping happens asynchronously after the request is accepted. A 202 response means the job was queued successfully — mapping typically completes within seconds but may take a few minutes for profiles with large connection networks. A 200 response means none of the provided usernames were found. No connectors were queued, and the usernames are listed inusernames_not_found. In this case, users_added and users_exist are returned as null rather than empty arrays.
If every provided username already belongs to a connector in the team, the response is still 202. users_added is empty and the usernames are listed in users_exist. Check users_added to see whether new connectors were actually added.
If a username already exists as a connector in the team, it is skipped (no duplicates) and reported in users_exist. The overall response remains 202.
Groups
The optionalgroup parameter categorizes connectors within your team. All connectors in a single request receive the same assignment.
| Value | Use for |
|---|---|
employees | Current or former employees of your organization |
investors | Investors in your organization |
customers | Customers |
portfolio | Portfolio companies |
advisors | Advisors |
others | Any other relationship type |
Partner teams
Use thex-authenticate-team header to add connectors to a specific child team:
x-authenticate-team: <child_team_id>
child_team_id is returned when you create a child team.Authorizations
Body
application/json
LinkedIn URL slugs of the users to add as connectors. Accepts both username-only slugs (e.g. john-doe) and full profile URLs (e.g. https://linkedin.com/in/john-doe).
Member group to assign to the connector
Available options:
others, employees, investors, customers, portfolio, advisors Response
None of the provided LinkedIn slugs were found. No connectors were queued.
Was this page helpful?

