Skip to main content
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>"
  ]
}
'
{
  "usernames_not_found": [
    "<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.

​
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 the request was processed but no new connectors were queued (all provided usernames already exist in the team or none were found). If a username already exists as a connector in the team, it is silently skipped — no duplicate is created and the overall response remains 202.

​
Groups

The optional group parameter categorizes connectors within your team. All connectors in a single request receive the same assignment.
ValueUse for
employeesCurrent or former employees of your organization
investorsInvestors in your organization
customersCustomers
portfolioPortfolio companies
advisorsAdvisors
othersAny other relationship type
Omit the parameter to add connectors without a group assignment.

​
Partner teams

Use the x-authenticate-team header to add connectors to a specific child team: 
x-authenticate-team: <child_team_id>
Omitting the header adds connectors to the team associated with your API key. The child_team_id is returned when you create a child team.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
linkedin_usernames
string[]
required

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).

​
group
enum<string>

Member group to assign to the connector

Available options:
others,
employees,
investors,
customers,
portfolio,
advisors

Response

Request processed; no connectors were queued (all slugs resolved to existing members or none found)

​
usernames_not_found
string[]

LinkedIn URL slugs that were not found