Skip to main content
POST
Add connector(s) to the team
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 none of the provided usernames were found. No connectors were queued, and the usernames are listed in usernames_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 optional group parameter categorizes connectors within your team. All connectors in a single request receive the same assignment. 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:
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

None of the provided LinkedIn slugs were found. No connectors were queued.

usernames_not_found
string[]

LinkedIn URL slugs that were not found

users_added
string[]

LinkedIn slugs that were found and are being added as connectors.

users_exist
string[]

LinkedIn slugs that were found but are already connectors in the team (skipped).