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

# Create Lead List

> Create Lead List



## OpenAPI

````yaml post /lead-lists
openapi: 3.0.1
info:
  title: Amplemarket API V1 Docs
  version: v1
servers:
  - url: https://api.amplemarket.com
security:
  - bearerAuth: []
paths:
  /lead-lists:
    post:
      tags:
        - Lead List
      summary: Create Lead List
      description: Create Lead List
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - shared
                - owner
                - leads
                - type
              additionalProperties: false
              properties:
                name:
                  type: string
                shared:
                  type: boolean
                visible:
                  type: boolean
                owner:
                  type: string
                  format: email
                type:
                  type: string
                  enum:
                    - linkedin
                    - email
                    - titles_and_company
                options:
                  type: object
                  additionalProperties: false
                  properties:
                    reveal_phone_numbers:
                      type: boolean
                    validate_email:
                      type: boolean
                    enrich:
                      type: boolean
                leads:
                  type: array
                  description: You may send up to 10000 leads at a time.
                  maxItems: 10000
                  items:
                    type: object
                    additionalProperties: true
                    properties:
                      linkedin_url:
                        type: string
                      email:
                        type: string
                        format: email
                      title:
                        type: string
                      company_name:
                        type: string
                      company_domain:
                        type: string
        required: true
        description: Leads to create the list with
      responses:
        '202':
          description: Lead List accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response_lead_list_object'
              examples:
                'Type: linkedin':
                  value:
                    id: 019e8e97-33b4-77d9-af42-6d8540779e87
                    object: lead_list
                    name: my list
                    status: queued
                    url: >-
                      https://localhost:3000/dashboard/lead_lists/019e8e97-33b4-77d9-af42-6d8540779e87
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-06-03T17:45:34Z'
                    updated_at: '2026-06-03T17:45:34Z'
                    options:
                      reveal_phone_numbers: false
                      validate_email: true
                      enrich: true
                    leads: []
                    _links:
                      self:
                        href: /lead-lists/019e8e97-33b4-77d9-af42-6d8540779e87
                'Type: email':
                  value:
                    id: 019e8e97-342c-7565-8984-46dbf39d78cc
                    object: lead_list
                    name: my list
                    status: queued
                    url: >-
                      https://localhost:3000/dashboard/lead_lists/019e8e97-342c-7565-8984-46dbf39d78cc
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: email
                    created_at: '2026-06-03T17:45:34Z'
                    updated_at: '2026-06-03T17:45:34Z'
                    options:
                      reveal_phone_numbers: false
                      validate_email: true
                      enrich: true
                    leads: []
                    _links:
                      self:
                        href: /lead-lists/019e8e97-342c-7565-8984-46dbf39d78cc
                Blank name provided:
                  value:
                    id: 019e8e97-34a5-7879-9169-102b1cdf9f26
                    object: lead_list
                    name: Lead List created via API
                    status: queued
                    url: >-
                      https://localhost:3000/dashboard/lead_lists/019e8e97-34a5-7879-9169-102b1cdf9f26
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-06-03T17:45:34Z'
                    updated_at: '2026-06-03T17:45:34Z'
                    options:
                      reveal_phone_numbers: false
                      validate_email: true
                      enrich: true
                    leads: []
                    _links:
                      self:
                        href: /lead-lists/019e8e97-34a5-7879-9169-102b1cdf9f26
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Unsupported value (type):
                  value:
                    _errors:
                      - code: unsupported_value
                        title: Unsupported Value
                        detail: '''foo'' is not a supported type.'
                        source:
                          pointer: /type
                    object: error
                Missing value (type):
                  value:
                    _errors:
                      - code: missing_field
                        title: Missing Field
                        detail: 'Missing field from request: type'
                        source:
                          pointer: /type
                    object: error
                Missing field (owner):
                  value:
                    _errors:
                      - code: missing_field
                        title: Missing Field
                        detail: 'Missing field from request: owner'
                        source:
                          pointer: /owner
                    object: error
                Unsupported value (owner):
                  value:
                    _errors:
                      - code: unsupported_value
                        title: Unsupported Value
                        detail: '''null@example.com'' is not a valid owner'
                        source:
                          pointer: /owner
                    object: error
                Missing field (leads):
                  value:
                    _errors:
                      - code: missing_field
                        title: Missing Field
                        detail: 'Missing field from request: leads'
                        source:
                          pointer: /leads
                    object: error
                Unsupported value (leads over limit):
                  value:
                    _errors:
                      - code: unsupported_value
                        title: Unsupported Value
                        detail: Number of leads exceeds 10,000 limit.
                        source:
                          pointer: /leads
                    object: error
                Unsupported value (lead with no LinkedIn URL):
                  value:
                    _errors:
                      - code: unsupported_value
                        title: Unsupported Value
                        detail: 'Missing field from request: leads[0].linkedin_url'
                        source:
                          pointer: /leads/0/linkedin_url
                    object: error
                Unsupported value (lead with invalid LinkedIn URL):
                  value:
                    _errors:
                      - code: unsupported_value
                        title: Unsupported Value
                        detail: >-
                          Unsupported value provided for field:
                          leads[0].linkedin_url
                        source:
                          pointer: /leads/0/linkedin_url
                    object: error
              schema:
                $ref: '#/components/schemas/response_errors_object'
        '402':
          description: Insufficient credits
          content:
            application/json:
              examples:
                Insufficient credits:
                  value:
                    _errors:
                      - code: insufficient_credits
                        title: Insufficient Credits
                        detail: >-
                          You do not have enough credits to perform this
                          operation.
                    object: error
              schema:
                $ref: '#/components/schemas/response_errors_object'
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                      - code: internal_server_error
                        title: Internal Server Error
                        detail: Something went wrong.
                    object: error
              schema:
                $ref: '#/components/schemas/response_errors_object'
components:
  schemas:
    response_lead_list_object:
      type: object
      required:
        - id
        - object
        - name
        - status
        - url
        - shared
        - visible
        - owner
        - type
        - leads
        - _links
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        object:
          type: string
          enum:
            - lead_list
        name:
          type: string
        status:
          type: string
          enum:
            - queued
            - processing
            - completed
        url:
          type: string
        shared:
          type: boolean
        visible:
          type: boolean
        owner:
          type: string
          format: email
        type:
          type: string
          enum:
            - linkedin
            - email
            - title_and_company
            - name_and_company
            - salesforce
            - hubspot
            - person
            - adaptive
        created_at:
          type: string
          format: date_time
        updated_at:
          type: string
          format: date_time
        options:
          type: object
          required:
            - reveal_phone_numbers
            - validate_email
            - enrich
          additionalProperties: false
          properties:
            reveal_phone_numbers:
              type: boolean
            validate_email:
              type: boolean
            enrich:
              type: boolean
        leads:
          type: array
          items:
            $ref: '#/components/schemas/response_lead_list_entry_object'
        _errors:
          type: array
          items:
            $ref: '#/components/schemas/response_error_object'
        _links:
          $ref: '#/components/schemas/response_links_object'
    response_errors_object:
      type: object
      required:
        - object
        - _errors
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
            - error
        _errors:
          type: array
          items:
            $ref: '#/components/schemas/response_error_object'
        _links:
          $ref: '#/components/schemas/response_links_object'
    response_lead_list_entry_object:
      type: object
      required:
        - id
        - object
        - email
        - person_id
        - linkedin_url
        - linkedin
        - first_name
        - last_name
        - company_name
        - company_domain
        - industry
        - title
        - email_validation_result
        - data
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        object:
          type: string
          enum:
            - lead_list_entry
        email:
          type: string
          format: email
        person_id:
          type: string
          format: uuid
        linkedin_url:
          type: string
        linkedin:
          type: string
        first_name:
          type: string
        last_name:
          type: string
        company_name:
          type: string
        company_domain:
          type: string
        industry:
          type: string
        title:
          type: string
        email_validation_result:
          $ref: >-
            #/components/schemas/response_lead_list_entry_email_validation_result_object
        data:
          type: object
          additionalProperties: true
        phone_numbers:
          type: array
          items:
            $ref: '#/components/schemas/response_phone_number_object'
    response_error_object:
      type: object
      required:
        - code
        - title
        - detail
      additionalProperties: false
      properties:
        code:
          type: string
        title:
          type: string
        detail:
          type: string
        source:
          type: object
          additionalProperties: false
          properties:
            pointer:
              type: string
    response_links_object:
      type: object
      required:
        - self
      additionalProperties: false
      properties:
        self:
          $ref: '#/components/schemas/response_link_object'
        prev:
          $ref: '#/components/schemas/response_link_object'
        next:
          $ref: '#/components/schemas/response_link_object'
    response_lead_list_entry_email_validation_result_object:
      type: object
      required:
        - object
        - email
        - result
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
            - email_validation_result
        email:
          type: string
          format: email
        result:
          type: string
          enum:
            - deliverable
            - risky
            - undeliverable
            - unknown
    response_phone_number_object:
      type: object
      required:
        - object
        - id
        - number
        - type
      additionalProperties: true
      properties:
        object:
          type: string
          enum:
            - phone_number
        id:
          type: string
          format: uuid
        number:
          type: string
        type:
          type: string
          enum:
            - mobile
            - office
            - phone
            - landline
            - voip
            - direct
        source:
          type: string
          enum:
            - amplemarket
            - crm
            - user_uploaded
    response_link_object:
      type: object
      required:
        - href
      additionalProperties: false
      properties:
        href:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````