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

# Add multiple collaborators

> Add multiple collaborators from import data



## OpenAPI

````yaml post /v1/collaborators/import
openapi: 3.1.0
info:
  title: Capital Check In API
  description: >-
    API for the Capital Check In platform - Employee check-in management system
    with identity verification, geolocation, and schedule management
  license:
    name: MIT
  version: 1.0.0
  contact:
    name: Capital Check In Support
    email: hi@capitalcheckin.app
    url: https://capitalcheckin.app
servers:
  - url: https://api.capitalcheckin.app
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/collaborators/import:
    post:
      tags:
        - Collaborators
      summary: Add multiple collaborators
      description: Add multiple collaborators from import data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CollaboratorsImportRequest'
      responses:
        '201':
          description: Collaborators created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollaboratorsImportResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    CollaboratorsImportRequest:
      type: object
      required:
        - collaborators
      properties:
        collaborators:
          type: array
          items:
            $ref: '#/components/schemas/CollaboratorCreateRequest'
          description: List of collaborators to import
    CollaboratorsImportResponse:
      type: object
      properties:
        message:
          type: string
          description: Import result message
        created:
          type: integer
          description: Number of collaborators created
        failed:
          type: integer
          description: Number of collaborators that failed to import
        errors:
          type: array
          items:
            type: object
            properties:
              index:
                type: integer
                description: Index of the failed collaborator
              error:
                type: string
                description: Error message
          description: List of import errors
    CollaboratorCreateRequest:
      type: object
      required:
        - name
        - email
        - position
        - department
      properties:
        name:
          type: string
          minLength: 2
          description: Full name of the collaborator
        email:
          type: string
          format: email
          description: Email address (must be unique)
        phone:
          type: string
          description: Phone number
        position:
          type: string
          description: Job position or title
        department:
          type: string
          description: Department or team
        hire_date:
          type: string
          format: date
          description: Date when collaborator was hired
        salary:
          type: number
          description: Annual salary
        manager_id:
          type: string
          description: ID of the manager
        work_schedule:
          type: string
          description: Work schedule (full-time, part-time, etc.)
        location:
          type: string
          description: Work location
        emergency_contact:
          type: object
          properties:
            name:
              type: string
              description: Emergency contact name
            phone:
              type: string
              description: Emergency contact phone
            relationship:
              type: string
              description: Relationship to collaborator
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: OAuth2
      description: OAuth2 access token for authentication

````