---
title: "Create Lead List"
method: POST
path: "/lead-lists"
tags: ["Lead List"]
---

# Create Lead List

`POST /lead-lists`

Create Lead List

## Request body

- object
  - `name` string
  - `shared` boolean, required
  - `visible` boolean
  - `owner` string, email, required
  - `type` 'linkedin' | 'email' | 'titles_and_company', required
  - `options` object
    - `reveal_phone_numbers` boolean
    - `validate_email` boolean
    - `enrich` boolean
  - `leads` object[], required — You may send up to 10000 leads at a time.
    - `linkedin_url` string
    - `email` string, email
    - `title` string
    - `company_name` string
    - `company_domain` string
    - `phone_numbers` string[]
    - `context` object — Additional custom fields to store on the lead. These fields are flattened into the lead data fields.

## Response `202`

Lead List accepted

- ResponseLeadListObject
  - `id` string, uuid, required
  - `object` 'lead_list', required
  - `name` string, required
  - `status` 'queued' | 'processing' | 'completed', required
  - `url` string, required
  - `shared` boolean, required
  - `visible` boolean, required
  - `owner` string, email, required
  - `type` 'linkedin' | 'email' | 'title_and_company' | 'name_and_company' | 'salesforce' | 'hubspot' | 'person' | 'adaptive', required
  - `created_at` string, date_time
  - `updated_at` string, date_time
  - `options` object
    - `reveal_phone_numbers` boolean, required
    - `validate_email` boolean, required
    - `enrich` boolean, required
  - `leads` ResponseLeadListEntryObject[], required
    - `id` string, uuid, required
    - `object` 'lead_list_entry', required
    - `email` string, email, required
    - `person_id` string, uuid, required
    - `linkedin_url` string, required
    - `linkedin` string, required
    - `first_name` string, required
    - `last_name` string, required
    - `company_name` string, required
    - `company_domain` string, required
    - `industry` string, required
    - `title` string, required
    - `email_validation_result` ResponseLeadListEntryEmailValidationResultObject, required
      - `object` 'email_validation_result', required
      - `email` string, email, required
      - `result` 'deliverable' | 'risky' | 'undeliverable' | 'unknown', required
    - `data` object, required
    - `phone_numbers` ResponsePhoneNumberObject[]
      - `object` 'phone_number', required
      - `id` string, uuid, required
      - `number` string, required
      - `type` 'mobile' | 'office' | 'phone' | 'landline' | 'voip' | 'direct', required
      - `source` 'amplemarket' | 'crm' | 'user_uploaded'
      - `is_wrong_number` boolean, required
      - `is_dnc_listed` boolean — Present only when the account has phone number DNC list enabled
  - `_errors` ResponseErrorObject[]
    - `code` string, required
    - `title` string, required
    - `detail` string, required
    - `source` object
      - `pointer` string
  - `_links` ResponseLinksObject, required
    - `self` ResponseLinkObject, required
      - `href` string, required
    - `prev` ResponseLinkObject
      - `href` string, required
    - `next` ResponseLinkObject
      - `href` string, required

## Other responses

- `400` — Bad request
- `402` — Insufficient credits
- `500` — Internal server error

---

[API](https://skmtc.dev/amplemarket/apis/amplemarket-api-v1-docs.md) · [All operations](https://skmtc.dev/amplemarket/apis/amplemarket-api-v1-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/amplemarket/amplemarket-api-v1-docs/revisions/57f46eaa2dc9/schema)