> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theswarm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Connector

> Add one or more LinkedIn profiles as connectors to your 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](/docs/team-management/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.

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

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:

```http theme={null}
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](/docs/endpoints/v3/create-team).


## OpenAPI

````yaml openapi.json POST /team/add-connector
openapi: 3.1.0
info:
  title: Swarm API
  version: 1.0.0
  contact:
    name: The Swarm
    url: https://theswarm.com
    email: hello@theswarm.com
servers:
  - url: https://bee.theswarm.com
security:
  - ApiKeyAuth: []
tags:
  - name: profiles
    description: Operations related to profiles
  - name: companies
    description: Operations related to companies
  - name: teams
    description: Operations for managing teams and connectors
  - name: social
    description: Operations related to social media posts and interactions
  - name: mcp
    description: Model Context Protocol endpoint for AI assistant integrations
  - name: credits
    description: Operations related to credit usage
  - name: network-mapper
    description: Operations for mapping connections and relationships across your network
paths:
  /team/add-connector:
    post:
      tags:
        - teams
      summary: Add connector(s) to the team
      description: Add one or more LinkedIn users as connectors to the team
      operationId: addConnector
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                linkedin_usernames:
                  type: array
                  items:
                    type: string
                  description: >-
                    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:
                  type: string
                  description: Member group to assign to the connector
                  enum:
                    - others
                    - employees
                    - investors
                    - customers
                    - portfolio
                    - advisors
              required:
                - linkedin_usernames
      responses:
        '200':
          description: >-
            Request processed; no connectors were queued (all slugs resolved to
            existing members or none found)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddConnectorResponse'
        '202':
          description: Connector addition accepted and being processed asynchronously
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddConnectorResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '409':
          description: Connector limit exceeded for the team
        5XX:
          $ref: '#/components/responses/5XX'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    AddConnectorResponse:
      type: object
      properties:
        usernames_not_found:
          type: array
          items:
            type: string
          description: LinkedIn URL slugs that were not found
    ErrorResponse:
      type: object
      properties:
        code:
          description: Error status code
          type: integer
        errors:
          type: array
          items:
            type:
              - string
              - object
      required:
        - code
  responses:
    '400':
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    '401':
      description: Unauthorized
    '403':
      description: Forbidden
    5XX:
      description: Unexpected error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````