---
title: "Add Leads to a List"
method: POST
path: "/lead-lists/{id}/leads"
tags: ["Lead List", "Leads"]
---

# Add Leads to a List

`POST /lead-lists/{id}/leads`

Add Leads to a List

## Path parameters

- `id` string, required

## Request body

- object
  - `type` 'linkedin' | 'email' | 'titles_and_company'
  - `leads` object[], required — You can add up to 10,000 leads at a time. However, each Lead List can have a maximum of 60,000 leads. When approaching this limit, new leads will be added partially until the limit is reached. When the limit is hit, a 409 HTTP status code will be returned. Enriching, email validation, and reveal settings are inherited from the Lead List settings. If credits are spent, those will be deducted from the admin user of the account.
    - `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 Leads accepted

- object
  - `total` integer — Total number of leads processed in the request.
  - `total_added_to_lead_list` integer — Total number of leads successfully added to the lead list.

## Other responses

- `400` — Bad request
- `402` — Insufficient credits
- `404` — Not found
- `409` — Conflict
- `410` — Gone
- `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)