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

# Create Empty Prospect List

> Creates a new prospect list with no prospects inside the given Prospects campaign and returns it. Uses no credits and no Prospect Capacity. Refused when the plan is not active, when the campaign already holds its plan's maximum of prospect lists, or when the campaign is not a non-deleted Prospects campaign.



## OpenAPI

````yaml https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospect-list/create-empty-list
openapi: 3.1.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:
  /client/v2/prospect-list/create-empty-list:
    post:
      tags:
        - Prospects
      summary: Create Empty Prospect List
      description: >-
        Creates a new prospect list with no prospects inside the given Prospects
        campaign and returns it. Uses no credits and no Prospect Capacity.
        Refused when the plan is not active, when the campaign already holds its
        plan's maximum of prospect lists, or when the campaign is not a
        non-deleted Prospects campaign.
      operationId: ProspectListClientApiController_createEmptyList
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateEmptyListRequestDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateEmptyListResponseDto'
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientApiErrorResponseDto'
        '403':
          description: >-
            The caller cannot update the campaign, the plan is not active, or
            the campaign already holds its plan's maximum of prospect lists.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientApiErrorResponseDto'
      security:
        - api-key: []
components:
  schemas:
    CreateEmptyListRequestDto:
      type: object
      properties:
        listName:
          type: string
          minLength: 1
          description: Human-readable list name.
        campaignId:
          type: string
          format: uuid
          description: >-
            Non-deleted Prospects campaign the list is created in. An active
            plan and a free prospect-list slot in that campaign are required.
      required:
        - listName
        - campaignId
    CreateEmptyListResponseDto:
      type: object
      properties:
        status:
          type: string
          const: success
          description: Response status
        data:
          type: object
          description: Created prospect list
          properties:
            id:
              type: string
              format: uuid
              description: Prospect list ID
              examples:
                - cf33282b-b171-4d23-ae02-848499d793e4
            updatedAt:
              type: string
              description: Prospect list update timestamp
              examples:
                - '2025-06-30T14:02:07.456Z'
                - '2025-07-03T08:30:00.000Z'
            createdAt:
              type: string
              description: Prospect list creation timestamp
              examples:
                - '2025-06-30T14:02:07.456Z'
                - '2025-07-03T08:30:00.000Z'
            name:
              type: string
              description: Prospect list name
            campaignId:
              type: string
              format: uuid
              description: Parent campaign ID
              examples:
                - 8d256aa6-9b12-49a7-93ee-bf41634b5b60
            prospectsTotal:
              type: number
              description: Total prospects in the list
            isDeleted:
              type: boolean
              description: >-
                Whether the prospect list has been deleted. Deleted lists are
                not usable and should be treated as removed.
          required:
            - id
            - updatedAt
            - createdAt
            - name
            - campaignId
            - prospectsTotal
            - isDeleted
        message:
          type: string
          description: Success message
          examples:
            - Operation completed successfully
      required:
        - status
        - data
        - message
    ClientApiErrorResponseDto:
      type: object
      properties:
        status:
          type: string
          description: Response status
          example: error
          enum:
            - error
        data:
          type: 'null'
          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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.