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

# Add Prospect

> Single-prospect operation: adds one prospect to a prospect list inside a campaign. If the prospect already exists elsewhere in the owner's team, the duplicate behavior is controlled by `moveDuplicatedProspect`.



## OpenAPI

````yaml https://api.goextrovert.com/client/v2/docs-json post /api/client/v1/prospects
openapi: 3.0.0
info:
  title: Extrovert Client API
  description: >-
    Public API for Extrovert platform integration. Use your API key for
    authentication.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.goextrovert.com/
    description: API Server
security: []
tags: []
paths:
  /api/client/v1/prospects:
    post:
      tags:
        - Prospects (legacy)
      summary: Add Prospect
      description: >-
        Single-prospect operation: adds one prospect to a prospect list inside a
        campaign. If the prospect already exists elsewhere in the owner's team,
        the duplicate behavior is controlled by `moveDuplicatedProspect`.
      operationId: TargetUserClientApiController_addProspectToList
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateRequestDto2'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateResponseDto2'
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientApiErrorResponseDto'
      security:
        - api-key: []
components:
  schemas:
    CreateRequestDto2:
      type: object
      properties:
        prospectListId:
          type: string
          format: uuid
          description: ID of the prospect list to add the prospect to.
          example: cf33282b-b171-4d23-ae02-848499d793e4
        prospectProfileUrl:
          type: string
          description: LinkedIn profile URL of the prospect to add.
          example: https://www.linkedin.com/in/john-doe
        campaignId:
          type: string
          format: uuid
          description: ID of the campaign that owns the prospect list.
          example: 8d256aa6-9b12-49a7-93ee-bf41634b5b60
        moveDuplicatedProspect:
          type: boolean
          description: >-
            Controls behavior when the prospect already exists in another list
            or campaign of the same owner. If true, the prospect is moved into
            this list and campaign. If false, the request fails with an error.
      required:
        - prospectListId
        - prospectProfileUrl
        - campaignId
        - moveDuplicatedProspect
    CreateResponseDto2:
      type: object
      properties:
        status:
          type: string
          description: Response status
          enum:
            - success
        data:
          description: No response payload
          nullable: true
          enum:
            - null
          example: null
        message:
          type: string
          description: Success message
          example: Operation completed successfully
      required:
        - status
        - data
        - message
    ClientApiErrorResponseDto:
      type: object
      properties:
        status:
          type: string
          description: Response status
          example: error
          enum:
            - error
        data:
          type: object
          description: Response data
          example: null
        message:
          type: string
          description: Error message
          example: An error occurred while processing the request
      required:
        - status
        - data
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key for authentication

````