---
title: "Create a lead list"
method: POST
path: "/lists"
tags: ["Lists"]
---

# Create a lead list

`POST /lists`

## Request

- Base URL: `https://api.wappalyzer.com/v2`
- URL: `https://api.wappalyzer.com/v2/lists`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/wappalyzer/apis/wappalyzer-public-api/docs/lists/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- CreateListRequest
  - `categories` string[]
  - `technologies` object[]
    - `slug` string, required
    - `operator` string
    - `version` string
  - `keywords` string[]
  - `languages` string[]
  - `countries` string[]
  - `industries` string[]
  - `companySizes` integer[]
  - `tlds` string[]
  - `matchCountryLanguage` boolean
  - `matchTechnologies` 'or' | 'and' | 'not'
  - `subset` integer
  - `subsetSlice` integer
  - `minAge` integer: Newest verification calendar month, as a number of months before the current month (UTC).
  - `maxAge` integer: Oldest verification calendar month, as a number of months before the current month (UTC). The default includes the current month and two previous months.
  - `fromDate` integer
  - `requiredSets` string[]
  - `excludeNoTraffic` boolean
  - `excludeMultilingual` boolean
  - `sets` string[]: Result field sets to include in the exported rows. Use `signals` to add `technologySpend` and `trafficLevel` columns.
  - `callbackUrl` string, uri
  - `format` 'json' | 'csv'
  - `baseListId` string
  - `suppressionListId` string: A Ready suppression list uploaded by this account, containing domains to exclude. Its domains are fixed once validated. Can be combined with excludeListId to also exclude websites from an existing lead list. Exclusions apply before result limits and credit calculation.
  - `excludeListId` string
  - `rootPath` boolean
  - `subdomains` 'include' | 'exclude' | 'merge'

## Response `200`

Lead list accepted for pricing and generation.

- CreateListAccepted
  - `id` string, required
  - `status` 'Calculating', required

## Other responses

- `400`: The request payload or query string was invalid.
- `403`: Authorization failed, the resource or method is invalid, or the account lacks sufficient credits.
- `404`: A referenced list or suppression list does not exist or belongs to another account.
- `409`: Suppression list is not Ready.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/wappalyzer/apis/wappalyzer-public-api.md) - [All operations](https://skmtc.dev/wappalyzer/apis/wappalyzer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wappalyzer/apis/wappalyzer-public-api/revisions/a67fcb00b7c5?raw)