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

> Batch invite past participants to a new project. Send invitations to multiple participants in a single request for efficient re-engagement.

# Invite multiple past participants



## OpenAPI

````yaml put /v1/team-respondents/batch-invite
openapi: 3.0.0
info:
  title: Partner API
  description: Public API for partner integrations
  version: '1.0'
  contact: {}
servers:
  - url: https://api-staging.respondent.io
security: []
tags: []
paths:
  /v1/team-respondents/batch-invite:
    put:
      tags:
        - team-respondents
      summary: Invite multiple past participants
      description: >-
        Send project link invitation to multiple team respondents to allow them
        to sign up for your project.

        Can allow respondent to skip the screener questions.

        Requires organization feature: participant database.
      operationId: TeamRespondentsController_batchInvite
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchInviteTeamRespondentsDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchInviteTeamRespondentsResponseDto'
components:
  schemas:
    BatchInviteTeamRespondentsDto:
      type: object
      properties:
        projectId:
          type: string
          format: ObjectId
        participants:
          type: array
          items:
            $ref: '#/components/schemas/InviteRespondentDto'
        message:
          type: string
      required:
        - projectId
        - participants
        - message
    BatchInviteTeamRespondentsResponseDto:
      type: object
      properties:
        invitations:
          type: array
          items:
            $ref: '#/components/schemas/Invitation'
        skipped:
          type: array
          items:
            $ref: '#/components/schemas/InviteRespondentDto'
      required:
        - invitations
        - skipped
    InviteRespondentDto:
      type: object
      properties:
        profileId:
          type: string
          format: ObjectId
        skipScreenerQuestions:
          type: boolean
      required:
        - profileId
        - skipScreenerQuestions
    Invitation:
      type: object
      properties:
        id:
          type: string
          format: ObjectId
        createdAt:
          format: date-time
          type: string
        profileId:
          type: string
          format: ObjectId
        userId:
          type: string
          format: ObjectId
        organizationId:
          type: string
          format: ObjectId
        teamId:
          type: string
          format: ObjectId
        projectId:
          type: string
          format: ObjectId
        senderId:
          type: string
          format: ObjectId
        message:
          type: string
        eventUid:
          type: string
        remoteCommunicationDetails:
          type: string
        skipScreenerQuestions:
          type: boolean
        profile:
          $ref: '#/components/schemas/InvitationProfile'
        project:
          $ref: '#/components/schemas/InvitationProject'
        updatedAt:
          format: date-time
          type: string
      required:
        - id
        - createdAt
        - profileId
        - userId
        - organizationId
        - teamId
        - projectId
        - senderId
        - message
        - skipScreenerQuestions
        - profile
        - project
    InvitationProfile:
      type: object
      properties:
        id:
          type: string
          format: ObjectId
        firstName:
          type: string
        lastName:
          type: string
      required:
        - id
        - firstName
        - lastName
    InvitationProject:
      type: object
      properties:
        id:
          type: string
          format: ObjectId
        name:
          type: string
        inviteCode:
          type: string
        incentive:
          type: number
      required:
        - id
        - name
        - inviteCode
        - incentive

````