---
title: "Create prospect list"
method: POST
path: "/api/prospects/create_prospect_list"
tags: ["Prospect Lists"]
---

# Create prospect list

`POST /api/prospects/create_prospect_list`

Create a list of prospects that match your filters

## Request body

- object
  - `list` object, required
    - `name` string, required — Name of the list. e.g. "VP of Sales in San Francisco"
    - `max_profiles` integer, required — The number of results to return
    - `enrichment_level` 'none' | 'partial' | 'full' — > Enrichment level of the list. The default is partial. | Enrichment Level | Description | |--------|--------------------------------------| | none | Will enrich with contact data when you provide a Linkedin profile url or email. But will not find emails or phone numbers | | partial| Will find emails. | | full | Will find emails and phone numbers. |
    - `email_options` object — Types of emails to return.
      - `accept_work` boolean — Professional email address, i.e. tim.cooke@apple.com
      - `accept_personal` boolean — A personal email address, i.e. tcooke1960@gmail.com
      - `accept_generic` boolean — A generic email address, i.e. hello@apple.com
    - `skip_duplicates` boolean — Skip contacts previously found in other api lists. Contacts will be marked as duplicates and not processed.
    - `callback_url` string — URL to send the list update to. If not provided, the default webhook URL configured in your account settings will be used.
  - `filters` object, required
    - `first_name` string[] — exact match of first name
    - `last_name` string[] — exact match of last name
    - `job_title` object[] — a list of job titles to include/exclude. If you want an exact title match, use double quotes around your search. e.g. '"account manager"'
      - `v` string — Job title to search
      - `s` 'i' | 'e' — whether to include or exclude the job title
    - `job_title_level` string[]
    - `job_role` string[]
    - `job_sub_role` string[]
    - `location` Location[] — > | location type | format of name input | |-----------|-----------------------------| | city | 'city, state, country' | | state | 'state, country' | | country | 'country' |
      - `v` string — name of the location
      - `b` 'city' | 'state' | 'country' | 'continent' | 'group' — type of location
      - `s` 'i' | 'e' — whether to include or exclude the location
    - `skill` string[]
    - `school` string[] — exact match of school name
    - `major` string[]
    - `linkedin_slug` string[] — Can be in the format `https://linkedin.com/in/stephen-hakami-5babb21b0` or `stephen-hakami-5babb21b0`
    - `job_company` object[] — a list of company names to include/exclude
      - `v` string — Company name
      - `s` 'i' | 'e' — whether to include or exclude the company name
    - `past_company` object[] — a list of past company names to include/exclude. Note that this will return people who used to work at the company AND people who currently work at the company. If you want to exclude people who currently work at the company, use the `job_company` filter with the exclude flag.
      - `v` string — Company name
      - `s` 'i' | 'e' — whether to include or exclude the company name
    - `company_location` Location[] — > | location type | format of name input | |-----------|-----------------------------| | city | 'city, state, country' | | state | 'state, country' | | country | 'country' |
      - `v` string — name of the location
      - `b` 'city' | 'state' | 'country' | 'continent' | 'group' — type of location
      - `s` 'i' | 'e' — whether to include or exclude the location
    - `company_industry` object[] — a list of company industries to include/exclude. **How it works:** - Use `v` to specify the industry name - Use `s` to control filtering: 'i' = include, 'e' = exclude - If `s` is not specified, the industry will be included by default - You can mix include and exclude filters in the same request **Examples:** - Include only: `[{v: "building materials"}]` or `[{v: "building materials", s: "i"}]` - Exclude only: `[{v: "capital markets", s: "e"}]` - Mixed: `[{v: "building materials"}, {v: "capital markets", s: "e"}]` Valid industry values: | Value | |-------| | accounting | | airlines/aviation | | alternative dispute resolution | | alternative medicine | | animation | | apparel & fashion | | architecture & planning | | arts and crafts | | automotive | | aviation & aerospace | | banking | | biotechnology | | broadcast media | | building materials | | business supplies and equipment | | capital markets | | chemicals | | civic & social organization | | civil engineering | | commercial real estate | | computer & network security | | computer games | | computer hardware | | computer networking | | computer software | | construction | | consumer electronics | | consumer goods | | consumer services | | cosmetics | | dairy | | defense & space | | design | | e-learning | | education management | | electrical/electronic manufacturing | | entertainment | | environmental services | | events services | | executive office | | facilities services | | farming | | financial services | | fine art | | fishery | | food & beverages | | food production | | fund-raising | | furniture | | gambling & casinos | | government administration | | government relations | | graphic design | | health, wellness and fitness | | higher education | | hospital & health care | | hospitality | | human resources | | import and export | | individual & family services | | industrial automation | | information services | | information technology and services | | insurance | | international affairs | | international trade and development | | internet | | investment banking | | investment management | | judiciary | | law enforcement | | law practice | | legal services | | legislative office | | libraries | | logistics and supply chain | | luxury goods & jewelry | | machinery | | management consulting | | maritime | | market research | | marketing and advertising | | mechanical or industrial engineering | | media production | | medical devices | | medical practice | | mental health care | | military | | mining & metals | | motion pictures and film | | museums and institutions | | music | | nanotechnology | | newspapers | | non-profit organization management | | oil & energy | | online media | | outsourcing/offshoring | | package/freight delivery | | packaging and containers | | paper & forest products | | performing arts | | pharmaceuticals | | philanthropy | | photography | | plastics | | political organization | | primary/secondary education | | printing | | professional training & coaching | | program development | | public policy | | public relations and communications | | public safety | | publishing | | railroad manufacture | | ranching | | real estate | | recreational facilities and services | | religious institutions | | renewables & environment | | research | | restaurants | | retail | | security and investigations | | semiconductors | | shipbuilding | | sporting goods | | sports | | staffing and recruiting | | supermarkets | | telecommunications | | textiles | | think tanks | | tobacco | | translation and localization | | transportation/trucking/railroad | | utilities | | venture capital & private equity | | veterinary | | warehousing | | wholesale | | wine and spirits | | wireless | | writing and editing |
      - `v` string — Industry name. Must be one of the valid industry values.
      - `s` 'i' | 'e' — Include or exclude filter. Use 'i' to include this industry, 'e' to exclude it. If not specified, defaults to include.
    - `company_size` string[] — Company Headcount
    - `technologies` object[] — a list of technology slugs to include/exclude. If `s` is omitted, the technology is included by default.
      - `v` string, required — Technology slug
      - `s` 'i' | 'e' — whether to include or exclude the technology
    - `company_annual_growth` '0-5%' | '5-10%' | '10-20%' | '20-50%' | '50-100%' | '100%+' — Company Headcount Annual Growth
    - `department_size` string[] — > Department Headcount, the format is `{department_name}:{min_headcount}-{max_headcount}` e.g. `sales:10-50` For less than or greater than, use `min_headcount-` or `-max_headcount` e.g. `sales:10-` or `sales:-50` Available department names: | department_name | |-----------------| | legal | | media | | sales | | design | | health | | trades | | finance | | education | | marketing | | operations | | engineering | | real_estate | | human_resources | | customer_service | | public_relations |
    - `revenue` string[] — Company Revenue
    - `funding_date` object — Company Funding Date
      - `t` 'last' | 'any' — Whether the funding date is the last round's funding date or any funding date
      - `v` '60d' | '90d' | '180d' | '270d' | '1y' — Funding Date Range
    - `last_funding_min` '$500K' | '$1M' | '$5M' | '$10M' | '$25M' | '$50M' | '$100M' | '$250M' | '$500M' | '$1B' — Company Last Funding Amount Min
    - `last_funding_max` '$500K' | '$1M' | '$5M' | '$10M' | '$25M' | '$50M' | '$100M' | '$250M' | '$500M' | '$1B' — Company Last Funding Amount Max
    - `funding_min` '$500K' | '$1M' | '$5M' | '$10M' | '$25M' | '$50M' | '$100M' | '$250M' | '$500M' | '$1B' — Company Total Funding Amount Min
    - `funding_max` '$500K' | '$1M' | '$5M' | '$10M' | '$25M' | '$50M' | '$100M' | '$250M' | '$500M' | '$1B' — Company Total Funding Amount Max
    - `funding_stage` object — Company Funding Stage
      - `t` 'last' | 'any' — Whether the funding stage is the last round's funding stage or any funding stage
      - `v` string[] — Funding Stage
    - `funding_type` object — Company Funding Type
      - `t` 'last' | 'any' — Whether the funding type is the last round's funding type or any funding type
      - `v` string[] — Funding Type
    - `company_type` string[] — Company Type
    - `company_summary` object[] — a list of words to include/exclude in the company summary
      - `v` string — Words to search in the company summary
      - `s` 'i' | 'e' — whether to include or exclude the words
    - `year_founded_start` string — Company Year Founded Start
    - `year_founded_end` string — Company Year Founded End

## Response `200`

successful

- ListResponse
  - `status` object
    - `code` integer
    - `message` string
  - `type` 'list'
  - `data` object
    - `id` integer
    - `name` string
    - `status` string
    - `stats` object
      - `people` integer
      - `credits` object
        - `email_credits` integer, nullable
        - `phone_credits` integer, nullable
        - `export_credits` integer, nullable
        - `api_credits` object, nullable
          - `email_credits` integer
          - `phone_credits` integer
          - `scrape_credits` integer
          - `total` integer
    - `finished_at` string, date-time, nullable
    - `created_at` string, date-time
    - `enrichment_level` string
    - `email_options` object
      - `accept_work` boolean
      - `accept_personal` boolean
      - `accept_generic` boolean
    - `report_type` string

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

---

[API](https://skmtc.dev/wiza/apis/wiza-api-documentation.md) · [All operations](https://skmtc.dev/wiza/apis/wiza-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wiza/wiza-api-documentation/revisions/9773e985f208/schema)