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

# Create Team

> Create a new child team under your partner account.

<Note>
  Available for Swarm Partners only. [Get in touch](mailto:hello@theswarm.com) to learn more about becoming a partner.
</Note>

Creates a new child team under your partner account. The response returns a `team_id` — save this value, as it is required to authenticate subsequent requests on behalf of that team.

For a conceptual overview, see [Team Management — Create Team](/docs/team-management/team).

## Using the team\_id

Pass the returned `team_id` in the `x-authenticate-team` header to perform actions in the context of the child team:

```http theme={null}
x-authenticate-team: <team_id>
```

This header is supported by the following endpoints:

* [Search Profiles](/docs/endpoints/v3/search-profiles)
* [Fetch Profile](/docs/endpoints/v3/fetch-profile)
* [Search Companies](/docs/endpoints/v3/search-companies)
* [Fetch Company](/docs/endpoints/v3/fetch-company)
* [Relationships](/docs/endpoints/v3/relationships)
* [Add Connector](/docs/endpoints/v3/add-connector)

When the header is omitted, the action is performed in the context of the parent team.

## Team ownership

If `owner_email` is omitted, the parent team's owner automatically becomes the owner of the newly created child team.


## OpenAPI

````yaml openapi.json POST /team/create-team
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/create-team:
    post:
      tags:
        - teams
      summary: Create a child team
      description: Create a new child team under the authenticated team
      operationId: createTeam
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                team_name:
                  type: string
                  description: Name of the new team
                owner_email:
                  type: string
                  description: >-
                    Email of the team owner. If omitted, the current team's
                    owner is used.
                company_website:
                  type: string
                  description: >-
                    Company website to use for automatic network mapping. Cannot
                    be combined with company_linkedin_url.
                company_linkedin_url:
                  type: string
                  description: >-
                    Company LinkedIn URL to use for automatic network mapping.
                    Cannot be combined with company_website.
              required:
                - team_name
      responses:
        '200':
          description: Team created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  team_id:
                    type: string
                    format: uuid
                    description: ID of the newly created team
                required:
                  - team_id
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          description: Team owner not found
        '409':
          description: Team name already exists
        5XX:
          $ref: '#/components/responses/5XX'
      security:
        - ApiKeyAuth: []
components:
  responses:
    '400':
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    '401':
      description: Unauthorized
    '403':
      description: Forbidden
    5XX:
      description: Unexpected error
  schemas:
    ErrorResponse:
      type: object
      properties:
        code:
          description: Error status code
          type: integer
        errors:
          type: array
          items:
            type:
              - string
              - object
      required:
        - code
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````